Syncello API

The Syncello API provides a single REST endpoint to execute tools across all connected platforms. Every tool — Tape, Podio, ShareFile, and Shared — is available through the same interface.

Base Endpoint

POST https://api.syncello.io/v1/tools/:platform/:tool

Authentication

All requests require a Bearer token in the Authorization header. See Authentication for how to get your API key.

Authorization: Bearer YOUR_API_KEY

Request Format

Parameters can be sent as a JSON body or as query parameters. Both formats are supported on every endpoint.

JSON Body

curl -X POST https://api.syncello.io/v1/tools/tape/listApps \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"workspaceId": 123}'

Query Parameters

curl -X POST "https://api.syncello.io/v1/tools/tape/listApps?workspaceId=123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Format

Successful calls return the tool's result payload directly as the JSON body — there is no envelope. Each tool's response shape is shown in its "Response" example below. Failures return an error object:

// Success — the tool's payload, e.g. for tape/listApps:
{
  "apps": [ ... ],
  "total": 3
}

// Error
{
  "error": "Description of what went wrong" }

// Validation error (write tools) — includes per-field fixes
{
  "error": "Validation failed",
  "validation_errors": [
    { "field_id": 123, "field_label": "Status", "field_type": "category",
      "error": "Unknown option", "got": "Actve", "fix": "Use one of: Active, Inactive" }
  ],
  "hint": "Correct the fields above and retry."
}

Very large list results may be replaced by a truncation summary containing result_truncated: true, counts, and a few sample_items — narrow your filters or paginate when you see it.

Error Codes

Status	Meaning
200	Success
400	Invalid parameters
401	Missing or invalid API key
403	Insufficient permissions (scope/entitlement)
404	Tool or platform not found
429	Rate limit exceeded
500	Internal server error

Platforms