{"openapi":"3.1.0","info":{"title":"Twilio Bulk Exports (BYOK) API","version":"0.1.0","description":"Twilio Bulk Exports (BYOK) lets an AI assistant read your own Twilio Bulk Exports data through the Twilio Bulk Exports API with a key you supply (Account SID or API key SID (use a restricted API key, SID starts with SK, rather than the main Auth Token where possible)). Read-only: 5 tools (get_export, list_export_days, get_export_configuration, list_export_jobs, get_export_job). The BYOK key...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-twilio-bulkexports.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-twilio-bulkexports/docs"},"termsOfService":"https://connectorbay.com/byok-twilio-bulkexports/terms"},"servers":[{"url":"https://byok-twilio-bulkexports.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-twilio-bulkexports/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/get_export":{"post":{"operationId":"get_export","summary":"Get the export entry for one resource type (Messages, Calls, Conferences or Participants) with links to its days and con","description":"Get the export entry for one resource type (Messages, Calls, Conferences or Participants) with links to its days and configuration. Use for \"Is Twilio bulk export available for Messages\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"resource_type":{"description":"Which communication log: Messages, Calls, Conferences or Participants.","enum":["Messages","Calls","Conferences","Participants"],"title":"Resource Type","type":"string"}},"required":["resource_type"],"title":"get_exportArguments","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_export_days":{"post":{"operationId":"list_export_days","summary":"List the days that have a daily export file for a resource type, with file size in bytes and creation date. Only metadat","description":"List the days that have a daily export file for a resource type, with file size in bytes and creation date. Only metadata, not the file. Use for \"For which days does Twilio have a daily Messages export\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"resource_type":{"description":"Which communication log: Messages, Calls, Conferences or Participants.","enum":["Messages","Calls","Conferences","Participants"],"title":"Resource Type","type":"string"},"page_size":{"anyOf":[{"maximum":400,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many days to return (1 to 400, default 50).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging token: the PageToken value inside meta.next_page_url from the previous answer (leave empty for the first page).","title":"Page Token"}},"required":["resource_type"],"title":"list_export_daysArguments","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_export_configuration":{"post":{"operationId":"get_export_configuration","summary":"Get the daily export settings of a resource type: whether the export is enabled and the HTTP method of its notification ","description":"Get the daily export settings of a resource type: whether the export is enabled and the HTTP method of its notification webhook (the webhook URL is not returned). Use for \"Is the daily export of Twilio Calls enabled\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"resource_type":{"description":"Which communication log: Messages, Calls, Conferences or Participants.","enum":["Messages","Calls","Conferences","Participants"],"title":"Resource Type","type":"string"}},"required":["resource_type"],"title":"get_export_configurationArguments","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_export_jobs":{"post":{"operationId":"list_export_jobs","summary":"List custom export jobs of a resource type with date range, queue position and estimated completion. The notification em","description":"List custom export jobs of a resource type with date range, queue position and estimated completion. The notification email and webhook URL are not returned. Use for \"Which custom Twilio export jobs have been requested for Messages\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"resource_type":{"description":"Which communication log: Messages, Calls, Conferences or Participants.","enum":["Messages","Calls","Conferences","Participants"],"title":"Resource Type","type":"string"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many jobs to return (1 to 1000, default 50).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging token: the PageToken value inside meta.next_page_url from the previous answer (leave empty for the first page).","title":"Page Token"}},"required":["resource_type"],"title":"list_export_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_export_job":{"post":{"operationId":"get_export_job","summary":"Get one custom export job by SID: resource type, date range, queue position and estimated completion (notification email","description":"Get one custom export job by SID: resource type, date range, queue position and estimated completion (notification email and webhook URL are not returned). Use for \"How far along is Twilio export job JS\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"job_sid":{"description":"The SID of the export job: 'JS' followed by 32 hex characters.","maxLength":34,"title":"Job Sid","type":"string"}},"required":["job_sid"],"title":"get_export_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}}}}