Tags

List tags

Returns a paginated list of every tag in the workspace.

This is the entry point for cohort work: resolve a tag name to its id here, then apply it to sequences or (once supported) filter sequences by it.

The whole catalog is returned. There is no record-type filter. Tags rows are untyped, so "tags used on sequences" could only be derived from existing attachments, which would hide a tag that has just been created from the very lookup that precedes using it.

Example:

curl -X GET 'https://partner-api.nooks.in/v1/tags?filter[name]=cold' \
  -H "Authorization: Bearer nooks-api-..."
get/tags

Request

  • Base URL: https://partner-api.nooks.in/v1
  • URL: https://partner-api.nooks.in/v1/tags
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://oauth.nooks.in/oauth/authorize, token URL https://oauth.nooks.in/oauth/token)

Query parameters

page[size]integer

Number of items per page (max 100)

page[after]string

Cursor for fetching the next page. Opaque token returned by the API in links.next; callers should treat it as opaque and only pass values they received from a previous response. Malformed cursors return 400 Bad Request.

page[before]string

Cursor for fetching the previous page. Opaque token returned by the API in links.prev; callers should treat it as opaque and only pass values they received from a previous response. Malformed cursors return 400 Bad Request.

filter[name]string

Filter tags by exact name match, compared case-INSENSITIVELY. Tag names are unique per workspace on lower(name), so Cold and cold find the same tag, and this returns at most one result.

Response

Successful response

Example response

{
  "data": [
    {
      "id": "770e8400-e29b-41d4-a716-446655440010",
      "name": "cold",
      "createdAt": "2026-01-12T09:30:00Z",
      "updatedAt": "2026-01-12T09:30:00Z"
    }
  ],
  "links": {
    "first": "/v1/sequences?page[size]=50",
    "next": "/v1/sequences?page[size]=50&page[after]=eyJpZCI6IjU1MGU4NDAwLWUyOWItNDFkNC1hNzE2LTQ0NjY1NTQ0MDAwMCIsInYiOjF9"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.