Tasks
Give your software and AI agents access to real-world execution: structured requests for physical work, carried out by Ryde's provider network and returned with evidence. A Task is its own resource with its own lifecycle — how Ryde staffs it internally is not part of the contract and may change.
Give your software and AI agents access to real-world execution: structured requests for physical work, carried out by Ryde's provider network and returned with evidence. A Task is its own resource with its own lifecycle — how Ryde staffs it internally is not part of the contract and may change.
Lifecycle
QUOTED
|
CREATED
|
PROVIDER ASSIGNED (matched on skill, territory and availability)
|
STARTED
|
EVIDENCE COLLECTED (photos with content hashes, capture GPS,
| device timestamps, checklist answers)
COMPLETED (or CANCELLED, before work begins)Operations
GET /v1/tasks/types
Coming soon Sandbox supported
The task types this market can actually execute, with the evidence each one collects. Only types Ryde can staff are listed.
| Operation | list_task_types |
|---|---|
| Scope | tasks.read |
| Entitlement | None |
| Idempotency | Not required |
| MCP tool | list_task_types |
Example request
curl -s 'https://sandbox-api.ryde.us.com/v1/tasks/types' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"POST /v1/tasks/quote
Coming soon Sandbox supported
Price a task and confirm a qualified provider could be found for it before committing.
| Operation | quote_task |
|---|---|
| Scope | tasks.read |
| Entitlement | None |
| Idempotency | Not required |
| MCP tool | quote_task |
Example request
curl -sX POST 'https://sandbox-api.ryde.us.com/v1/tasks/quote' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{ … }'POST /v1/tasks
Coming soon Ryde One required Sandbox supported
Dispatch real-world work with structured requirements and evidence rules.
| Operation | create_task |
|---|---|
| Scope | tasks.create |
| Entitlement | Ryde One required |
| Idempotency | Required |
| MCP tool | create_task |
Requires a fresh quote the customer was shown, plus an Idempotency-Key.
Example request
curl -sX POST 'https://sandbox-api.ryde.us.com/v1/tasks' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
-H "Idempotency-Key: $(uuidgen)" \
-H 'Content-Type: application/json' \
-d '{ … }'GET /v1/tasks/{task_id}
Coming soon Sandbox supported
Task state, the assigned provider, and the evidence collected so far.
| Operation | get_task |
|---|---|
| Scope | tasks.read |
| Entitlement | None |
| Idempotency | Not required |
| MCP tool | get_task |
Example request
curl -s 'https://sandbox-api.ryde.us.com/v1/tasks/$task_id' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"GET /v1/tasks/{task_id}/evidence
Coming soon Sandbox supported
The evidence collected against a task: photos with their content hashes, capture GPS and device timestamps, and any checklist answers.
| Operation | get_task_evidence |
|---|---|
| Scope | tasks.read |
| Entitlement | None |
| Idempotency | Not required |
| MCP tool | get_task_evidence |
Example request
curl -s 'https://sandbox-api.ryde.us.com/v1/tasks/$task_id/evidence' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"POST /v1/tasks/{task_id}/cancel
Coming soon Sandbox supported
Cancel a task that has not started.
| Operation | cancel_task |
|---|---|
| Scope | tasks.read |
| Entitlement | None |
| Idempotency | Supported |
| MCP tool | cancel_task |
Example request
curl -sX POST 'https://sandbox-api.ryde.us.com/v1/tasks/$task_id/cancel' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{ … }'