{"openapi":"3.1.0","info":{"title":"Transifex (BYOK) API","version":"0.1.0","description":"Transifex (BYOK) lets an AI assistant read your own Transifex data through the Transifex API with a key you supply (Transifex API token). Read-only: 10 tools (list_organizations, list_projects, get_project, list_project_languages, list_resources, list_resource_language_stats, list_source_strings, list_translations, list_tasks, list_teams). The BYOK key travels with each request, is used for that...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-transifex.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-transifex/docs"},"termsOfService":"https://connectorbay.com/byok-transifex/terms"},"servers":[{"url":"https://byok-transifex.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-transifex/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_organizations":{"post":{"operationId":"list_organizations","summary":"List the Transifex organizations the token's user belongs to (name, slug, private flag). Use for \"Which Transifex organi","description":"List the Transifex organizations the token's user belongs to (name, slug, private flag). Use for \"Which Transifex organizations am I in\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: the page[cursor] value found in links.next of the previous answer. Pages hold 150 items.","title":"Page Cursor"}},"title":"list_organizationsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_projects":{"post":{"operationId":"list_projects","summary":"List the projects of one organization with type (live or file), archived flag and dates. Use for \"Which Transifex projec","description":"List the projects of one organization with type (live or file), archived flag and dates. Use for \"Which Transifex projects does the organization have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"filter_organization":{"description":"Organization id in the form o:<organization_slug>, for example o:acme.","maxLength":200,"title":"Filter Organization","type":"string"},"filter_name":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only projects with this name.","title":"Filter Name"},"page_cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: the page[cursor] value found in links.next of the previous answer. Pages hold 150 items.","title":"Page Cursor"}},"required":["filter_organization"],"title":"list_projectsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_project":{"post":{"operationId":"get_project","summary":"Get details of one project: description, type, archived and fill-up settings, dates. Use for \"Show the settings of this ","description":"Get details of one project: description, type, archived and fill-up settings, dates. Use for \"Show the settings of this Transifex project\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Transifex project id in the form o:<organization_slug>:p:<project_slug>, for example o:acme:p:website.","maxLength":200,"title":"Project Id","type":"string"}},"required":["project_id"],"title":"get_projectArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_project_languages":{"post":{"operationId":"list_project_languages","summary":"List the target languages of a project (code, name, right-to-left flag). Use for \"Which target languages does this Trans","description":"List the target languages of a project (code, name, right-to-left flag). Use for \"Which target languages does this Transifex project have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Transifex project id in the form o:<organization_slug>:p:<project_slug>, for example o:acme:p:website.","maxLength":200,"title":"Project Id","type":"string"}},"required":["project_id"],"title":"list_project_languagesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_resources":{"post":{"operationId":"list_resources","summary":"List the resources (source files or string groups) of a project with string and word counts. Use for \"Which resources ar","description":"List the resources (source files or string groups) of a project with string and word counts. Use for \"Which resources are in this Transifex project\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"filter_project":{"description":"Transifex project id in the form o:<organization_slug>:p:<project_slug>, for example o:acme:p:website.","maxLength":200,"title":"Filter Project","type":"string"},"filter_name":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only resources with this name.","title":"Filter Name"},"page_cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: the page[cursor] value found in links.next of the previous answer. Pages hold 150 items.","title":"Page Cursor"}},"required":["filter_project"],"title":"list_resourcesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_resource_language_stats":{"post":{"operationId":"list_resource_language_stats","summary":"Completion statistics per resource and language for a project: total, translated, reviewed and proofread strings and wor","description":"Completion statistics per resource and language for a project: total, translated, reviewed and proofread strings and words. Use for \"How translated is each language in this Transifex project\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"filter_project":{"description":"Transifex project id in the form o:<organization_slug>:p:<project_slug>, for example o:acme:p:website.","maxLength":200,"title":"Filter Project","type":"string"},"filter_resource":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only this resource id (Transifex resource id in the form o:<organization_slug>:p:<project_slug>:r:<resource_slug>.).","title":"Filter Resource"},"filter_language":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only this language id, for example l:de.","title":"Filter Language"},"page_cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: the page[cursor] value found in links.next of the previous answer. Pages hold 150 items.","title":"Page Cursor"}},"required":["filter_project"],"title":"list_resource_language_statsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_source_strings":{"post":{"operationId":"list_source_strings","summary":"List the source strings of a resource with key, context, tags and character limit. Use for \"Show the source strings of t","description":"List the source strings of a resource with key, context, tags and character limit. Use for \"Show the source strings of this Transifex resource\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"filter_resource":{"description":"Transifex resource id in the form o:<organization_slug>:p:<project_slug>:r:<resource_slug>.","maxLength":200,"title":"Filter Resource","type":"string"},"filter_key":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Exact, case-sensitive key of one string.","title":"Filter Key"},"page_cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: the page[cursor] value found in links.next of the previous answer. Pages hold 150 items.","title":"Page Cursor"}},"required":["filter_resource"],"title":"list_source_stringsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_translations":{"post":{"operationId":"list_translations","summary":"List the translations of one resource into one language with their translated, reviewed and proofread flags. Use for \"Sh","description":"List the translations of one resource into one language with their translated, reviewed and proofread flags. Use for \"Show the German translations of this Transifex resource\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"filter_resource":{"description":"Transifex resource id in the form o:<organization_slug>:p:<project_slug>:r:<resource_slug>.","maxLength":200,"title":"Filter Resource","type":"string"},"filter_language":{"description":"Language id, for example l:de.","maxLength":200,"title":"Filter Language","type":"string"},"filter_translated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to keep only translated strings, false for untranslated ones.","title":"Filter Translated"},"filter_reviewed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to keep only reviewed translations.","title":"Filter Reviewed"},"page_cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: the page[cursor] value found in links.next of the previous answer. Pages hold 150 items.","title":"Page Cursor"}},"required":["filter_resource","filter_language"],"title":"list_translationsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_tasks":{"post":{"operationId":"list_tasks","summary":"List the translation tasks of an organization with status, priority, due date and type, optionally for one project. Use ","description":"List the translation tasks of an organization with status, priority, due date and type, optionally for one project. Use for \"What Transifex tasks are open\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"filter_organization":{"description":"Organization id in the form o:<organization_slug>.","maxLength":200,"title":"Filter Organization","type":"string"},"filter_project":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Transifex project id in the form o:<organization_slug>:p:<project_slug>, for example o:acme:p:website.","title":"Filter Project"},"filter_statuses":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Task status, for example PENDING or FINISHED.","title":"Filter Statuses"},"page_cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: the page[cursor] value found in links.next of the previous answer. Pages hold 150 items.","title":"Page Cursor"}},"required":["filter_organization"],"title":"list_tasksArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_teams":{"post":{"operationId":"list_teams","summary":"List the translator teams of an organization. Use for \"Which translator teams does this Transifex organization have\".","description":"List the translator teams of an organization. Use for \"Which translator teams does this Transifex organization have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"filter_organization":{"description":"Organization id in the form o:<organization_slug>.","maxLength":200,"title":"Filter Organization","type":"string"},"page_cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: the page[cursor] value found in links.next of the previous answer. Pages hold 150 items.","title":"Page Cursor"}},"required":["filter_organization"],"title":"list_teamsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}