{"openapi":"3.1.0","info":{"title":"Together AI (BYOK) API","version":"0.1.0","description":"Together AI (BYOK) lets an AI assistant read your own Together AI data through the Together AI API with a key you supply (API key). Read-only: 8 tools (whoami, list_models, list_files, list_fine_tuning_jobs, list_batches, list_endpoints, list_hardware, list_evaluation_jobs). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-together.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-together/docs"},"termsOfService":"https://connectorbay.com/byok-together/terms"},"servers":[{"url":"https://byok-together.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-together/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/whoami":{"post":{"operationId":"whoami","summary":"Show which project and organization the key belongs to. Use for \"Which Together AI project is my key connected to\".","description":"Show which project and organization the key belongs to. Use for \"Which Together AI project is my key connected to\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"whoamiArguments","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_models":{"post":{"operationId":"list_models","summary":"List Together AI models with type, context length and prices (USD per million tokens where applicable). The list is long","description":"List Together AI models with type, context length and prices (USD per million tokens where applicable). The list is long. Use for \"Which Together AI chat models have the largest context window\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dedicated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to list only models that can run on dedicated endpoints.","title":"Dedicated"}},"title":"list_modelsArguments","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_files":{"post":{"operationId":"list_files","summary":"List files uploaded to your Together AI project with name, size, purpose and processing status. Use for \"What training f","description":"List files uploaded to your Together AI project with name, size, purpose and processing status. Use for \"What training files have I uploaded to Together AI\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_filesArguments","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_fine_tuning_jobs":{"post":{"operationId":"list_fine_tuning_jobs","summary":"List your Together AI fine-tuning jobs with base model, status, epochs, token count, price and timestamps. Use for \"What","description":"List your Together AI fine-tuning jobs with base model, status, epochs, token count, price and timestamps. Use for \"What is the status of my Together AI fine-tuning jobs\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_fine_tuning_jobsArguments","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_batches":{"post":{"operationId":"list_batches","summary":"List your Together AI batch jobs with model, endpoint, status, progress and deadline. Use for \"Are my Together AI batch ","description":"List your Together AI batch jobs with model, endpoint, status, progress and deadline. Use for \"Are my Together AI batch jobs finished\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_batchesArguments","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_endpoints":{"post":{"operationId":"list_endpoints","summary":"List dedicated and serverless inference endpoints in your Together AI account with model, state and owner. Use for \"Whic","description":"List dedicated and serverless inference endpoints in your Together AI account with model, state and owner. Use for \"Which dedicated endpoints are running in my Together AI account\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"type":{"anyOf":[{"enum":["dedicated","serverless"],"type":"string"},{"type":"null"}],"default":null,"description":"Only endpoints of this type.","title":"Type"},"usage_type":{"anyOf":[{"enum":["on-demand","reserved"],"type":"string"},{"type":"null"}],"default":null,"description":"Only endpoints with this billing type.","title":"Usage Type"},"mine":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to show only endpoints you own.","title":"Mine"}},"title":"list_endpointsArguments","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_hardware":{"post":{"operationId":"list_hardware","summary":"List hardware configurations available for dedicated endpoints with GPU type, memory, GPU count, price per minute in cen","description":"List hardware configurations available for dedicated endpoints with GPU type, memory, GPU count, price per minute in cents and availability. Use for \"What GPU hardware can I use for a Together AI dedicated endpoint and is it available\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"model":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only hardware that can serve this model name.","title":"Model"}},"title":"list_hardwareArguments","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_evaluation_jobs":{"post":{"operationId":"list_evaluation_jobs","summary":"List your Together AI model evaluation jobs with type, status and timestamps. Use for \"Which model evaluations have I ru","description":"List your Together AI model evaluation jobs with type, status and timestamps. Use for \"Which model evaluations have I run on Together AI\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"status":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only evaluation jobs with this status.","title":"Status"},"limit":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many jobs to return (default 10).","title":"Limit"}},"title":"list_evaluation_jobsArguments","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}}}}