API resources, IDs, pagination, and errors

The v1 API covers a set of Sydnee resources. It does not cover every feature in the app.

Which resources are available?

• Accounts: create, list, read, and archive client accounts.
• Account users: list account members, add a portal user, and remove account access.
• Task boards: list, create, archive, restore, and set a default board.
• Sections and tags: manage board sections, board-local tags, and their order.
• Tasks: list, create, read, move, update, archive, and manage supported subtasks, tags, reminders, assignees, collaborators, comments, attachments, and activity.
• Task templates: list templates and add one to an account or one account task board.
• Request templates: list templates and send one to a portal user.
• Files: list folders and files, read file details, versions, and comments, and get signed download URLs.

Public file routes are read-only. They do not upload, rename, delete, comment on, or add a version to a file.

The live API reference owns the full route and field list.

Which ID should I send?

Use the ID returned by the endpoint that listed or created the resource. Do not build an ID from a name, slug, URL, or database guess.

An account user's ID is not the same as the person's portal-user ID or email. A file's current ID can also differ from an older version ID. Follow the exact schema for the route you call.

How does pagination work?

Cursor pagination is used by supported list routes, including accounts, task activity, task comments, file lists, and file comments.

1. Send the first request with an optional limit. Supported paged routes return 50 items by default and allow 1 to 200.
2. Read nextCursor from the response.
3. Send that exact value as the next request's cursor.
4. Stop when nextCursor is empty or missing.

Some responses also return a Link header with rel="next". A cursor is opaque. Do not decode, edit, or reuse it with another route or filter.

Not every list route uses a cursor. Check the endpoint in the live reference.

What are the rate limits?

Current /v1 limits are shared by the workspace:

• 300 GET requests per minute;
• 100 write requests per minute.

A limited request returns 429. Follow Retry-After. The response can also include X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset.

What does an API error mean?

Errors use this basic shape:

{
  "error": {
    "code": "400",
    "message": "Validation failed",
    "issues": []
  }
}

• code is a string.
• message explains the main problem.
• issues can point to invalid fields.
• details can hold a safe conflict code or current value.
• id can appear as a support or error-trace value.
• agentHint can tell an automated client how to report a server error.

Common status codes are:

Next step

• API quickstart and authentication
• Open the generated API reference
• Fix API and Zapier problems