POST /tool-endpoints/sync
Updated Oct 1, 20261 minute read
Sync the tools
Re-reads one endpoint's manifest. Pass its exact URL when more than one endpoint is connected. The URL may be omitted when there is exactly one. Answers as soon as the sync is scheduled, so read the endpoints back for what it found.
Syncs have their own limit of 60 an hour per organization, with a burst of 10. Past it, this returns 429 rate_limited with "Too many requests. Wait a moment and try again." An OAuth token needs an admin or owner.
Part of Tool endpoint.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
url | query | string | No | The exact endpoint URL to sync. Required when more than one is connected. |
Responses
| Status | Description |
|---|---|
202 | The sync was scheduled. |
400 | no_endpoint: no tool endpoint is connected. endpoint_required: several are connected and no url was sent. |
401 | missing_api_key: no bearer token. invalid_api_key: the key matches no organization or was revoked. publishable_key: a median_pk_ key was sent. invalid_token: the OAuth token is unknown or expired. |
403 | With an OAuth token, forbidden when the person is not an admin or owner, and no_organization when no organization is bound. |
404 | endpoint_not_found: the url matches no connected endpoint. |
429 | The organization's API allowance for this class of request is used up. Wait the Retry-After header's seconds. Limits depend on the plan. See rate limits. |
202 body
| Field | Type | Required | Description |
|---|---|---|---|
ok | boolean | No |
Example response
{
"ok": true
}Example request
curl -X POST https://api.median.sh/v1/tool-endpoints/sync \
-H "Authorization: Bearer $MEDIAN_KEY"