Curator API: Update a Source
PUT https://api.curator.io/v1.3/sources/SOURCE_ID pauses or resumes a source, or changes what it pulls from. PATCH and POST to the same URL do the same thing. The request needs your API key, and your plan must include API access. Only HTTPS is supported.
Authentication
Send your Curator API key (find it in the Curator Dashboard) in one of three ways: as a query string (?api_key=API_KEY), as a Basic auth header with the API key as the username, or as a Bearer token (Authorization: Bearer API_KEY, with Bearer capitalised). You can only update sources in the account the key belongs to.
Example request
curl -X PATCH "https://api.curator.io/v1.3/sources/SOURCE_ID" \
-H "Authorization: Bearer API_KEY" \
-H "Content-Type: application/json" \
-d '{"tag": "https://www.curator.io/blog/rss", "status": "paused"}'Parameters
Send parameters as JSON or form fields. Only tag and status can be changed; other fields are ignored.
Parameter | Description |
|---|---|
| The source's API ID (a UUID). |
| What the source pulls from, up to 200 characters. It must be sent every time, even when you only change |
|
|
Response
A 200 response with the updated source object (described in Curator API: Get Sources, without account) in data.
Errors
Status | When | Body |
|---|---|---|
401 | The API key is missing or not valid. |
|
403 | Your plan does not include API access. |
|
404 | No source in your account has that ID. |
|
422 |
|
|
422 |
|
|
429 | When rate limiting is enabled, more than 60 requests per minute. |
|