{"openapi":"3.1.0","info":{"title":"Together AI training sessions, model resources, checkpoints and FP4 jobs (your key) API","version":"0.1.0","description":"Together AI training sessions, model resources, checkpoints and FP4 jobs (your key) lets an AI assistant read your own Together AI Post-Training data through the Together AI Post-Training API with a key you supply (API key). Read-only: 10 tools (list_supported_models, list_model_resources, get_model_resources, list_training_sessions, get_training_session, list_checkpoints, get_checkpoint,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-together-post-training.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-together-post-training/docs"},"termsOfService":"https://connectorbay.com/byok-together-post-training/terms"},"servers":[{"url":"https://byok-together-post-training.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-together-post-training/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_supported_models":{"post":{"operationId":"list_supported_models","summary":"List the base models the Together post-training service supports with default GPU type and compute configurations. Use f","description":"List the base models the Together post-training service supports with default GPU type and compute configurations. Use for \"Which models can I train with Together AI post-training\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_supported_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_model_resources":{"post":{"operationId":"list_model_resources","summary":"List your post-training model resources (provisioned compute for a base model) with status, GPU type and replica count. ","description":"List your post-training model resources (provisioned compute for a base model) with status, GPU type and replica count. Use for \"Which Together AI model resources are running right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (default 20).","title":"Limit"},"after":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor: meta.next_cursor of the previous page.","title":"After"},"created_by":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only resources created by this user id.","title":"Created By"}},"title":"list_model_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/get_model_resources":{"post":{"operationId":"get_model_resources","summary":"Get one model resource with status, error details, compute configuration and optimizer settings. Use for \"What is the st","description":"Get one model resource with status, error details, compute configuration and optimizer settings. Use for \"What is the status of one of my Together AI model resources\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"model_resources_id":{"description":"Model resources id, as returned by list_model_resources.","maxLength":200,"title":"Model Resources Id","type":"string"}},"required":["model_resources_id"],"title":"get_model_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_training_sessions":{"post":{"operationId":"list_training_sessions","summary":"List your post-training sessions with status, base model, current step, LoRA settings and timestamps. Use for \"Which Tog","description":"List your post-training sessions with status, base model, current step, LoRA settings and timestamps. Use for \"Which Together AI training sessions are running and what step are they on\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (default 20).","title":"Limit"},"after":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor: meta.next_cursor of the previous page.","title":"After"},"model_resources_id":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only sessions attached to this model resources id.","title":"Model Resources Id"},"created_by":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only sessions created by this user id.","title":"Created By"}},"title":"list_training_sessionsArguments","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_training_session":{"post":{"operationId":"get_training_session","summary":"Get one training session with status, error details, LoRA configuration, policy state and its checkpoint lists. Use for ","description":"Get one training session with status, error details, LoRA configuration, policy state and its checkpoint lists. Use for \"How far along is one of my Together AI training sessions\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"session_id":{"description":"Training session id, as returned by list_training_sessions.","maxLength":200,"title":"Session Id","type":"string"}},"required":["session_id"],"title":"get_training_sessionArguments","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_checkpoints":{"post":{"operationId":"list_checkpoints","summary":"List training and inference checkpoints, newest first, with type, base model, LoRA rank and step. Use for \"Which checkpo","description":"List training and inference checkpoints, newest first, with type, base model, LoRA rank and step. Use for \"Which checkpoints did my Together AI training session save\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (default 20).","title":"Limit"},"after":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor: meta.next_cursor of the previous page.","title":"After"},"session_id":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only checkpoints of this training session.","title":"Session Id"},"base_model":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only checkpoints of this base model.","title":"Base Model"},"type":{"anyOf":[{"enum":["CHECKPOINT_TYPE_TRAINING","CHECKPOINT_TYPE_INFERENCE"],"type":"string"},{"type":"null"}],"default":null,"description":"Only this checkpoint type.","title":"Type"}},"title":"list_checkpointsArguments","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_checkpoint":{"post":{"operationId":"get_checkpoint","summary":"Get metadata of one checkpoint: type, base model, LoRA rank, step and owning session. No model files are downloaded. Use","description":"Get metadata of one checkpoint: type, base model, LoRA rank, step and owning session. No model files are downloaded. Use for \"What are the details of one Together AI checkpoint\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Checkpoint id, as returned by list_checkpoints.","maxLength":200,"title":"Id","type":"string"}},"required":["id"],"title":"get_checkpointArguments","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_fp4_jobs":{"post":{"operationId":"list_fp4_jobs","summary":"List FP4 preparation (quantization) jobs of your project with status and result model ids. Use for \"Which of my Together","description":"List FP4 preparation (quantization) jobs of your project with status and result model ids. Use for \"Which of my Together AI FP4 preparation jobs finished\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_fp4_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/get_fp4_job":{"post":{"operationId":"get_fp4_job","summary":"Get one FP4 preparation job with status, parameters and result. Use for \"What is the status of one of my Together AI FP4","description":"Get one FP4 preparation job with status, parameters and result. Use for \"What is the status of one of my Together AI FP4 preparation jobs\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Shaping job id, as returned by list_fp4_jobs.","maxLength":200,"title":"Id","type":"string"}},"required":["id"],"title":"get_fp4_jobArguments","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_fp4_job_events":{"post":{"operationId":"list_fp4_job_events","summary":"List the progress events of an FP4 preparation job with level, type and message. Use for \"What happened during my Togeth","description":"List the progress events of an FP4 preparation job with level, type and message. Use for \"What happened during my Together AI FP4 preparation job\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Shaping job id, as returned by list_fp4_jobs.","maxLength":200,"title":"Id","type":"string"}},"required":["id"],"title":"list_fp4_job_eventsArguments","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}}}}