← Modal

Can an agent start a sandbox with Modal Sandboxes?

The agent needs you to point it to the interface, sign it up or register a client, provide a key or token and add a payment card. You also handle changes to its access.

observedProbed revision sha256:2b6a41fa84a3…

Who does each step

Whether the agent handles it alone or a person has to step in.

  1. 01

    Discover

    Workaround · setup

    The documents checked don't give the agent enough information to find or call this job. You provide the missing details.

  2. 02

    Access

    Workaround · setup

    You give the agent a key or token.

  3. 03

    Onboard

    Workaround · setup

    You sign up or register a client for the agent.

  4. 04

    Pay

    Workaround · setup

    You add a payment card at the vendor's checkout.

  5. 05

    Confirm

    Machine

    The response or specification defines errors the agent can distinguish from success.

  6. 06

    Sustain

    Workaround · setup

    You replace or revoke the agent's access when it needs to change.

  • Discover: telling the agent where the interface is or how to call it.
  • Access: handing over a key or token.
  • Onboard: signing up or registering a client for the agent.
  • Pay: adding a payment card.
  • Sustain: renewing, replacing or revoking its access.

To remove these handoffs: publish a machine-readable descriptor on modal.com for Modal Sandboxes that leads to a specification covering this job; support OAuth client registration so the agent can register its own client and ask for consent; provide an agent registration route, such as auth.md, a sign-up API or OAuth client registration; support payment in the request, such as x402 or MPP, so setup does not require a person to add a card; provide key management or OAuth refresh and revocation so the agent can maintain its own access.

Agent surfaces

2 kinds · 2 entries
APIThe job's request went here
For agentsllms.txt

The probe

12 Oct 2026 · 11:17 UTC · 61.68 s

Each request it sent and what came back; the descriptors it read, counted, with what they named.

Discover36 descriptor reads1 fact
Found
For agentsmodal.com/llms.txt
From
modal.com/llms.txt
This endpoint
api.modal.com is named by none of them
Job requestPOST api.modal.com/modal.client.ModalClient/SandboxCreate20039 ms
Request
POST https://api.modal.com/modal.client.ModalClient/SandboxCreate
Response
200 · application/grpc · 0 bytes
Body
sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
Exchange
sha256:15c245ef8fe7d7b4bf7519bff4d0fd2f2af48e1ed9cece6e76a43b3bccf4eb3a
Resource metadataGET api.modal.com/.well-known/oauth-protected-resource/modal.client.ModalClient/SandboxCreate200142 ms
Request
GET https://api.modal.com/.well-known/oauth-protected-resource/modal.client.ModalClient/SandboxCreate
Response
200 · application/grpc · 0 bytes
Body
sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
Exchange
sha256:e4ca585393c7b3aaee2617024349969927935d29e7307f01e4127b76d6286bb9
Resource metadataGET api.modal.com/.well-known/oauth-protected-resource200139 ms
Request
GET https://api.modal.com/.well-known/oauth-protected-resource
Response
200 · application/grpc · 0 bytes
Body
sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
Exchange
sha256:ea3041a979b6886cf7d7605777065530ecee0b6f433c1507de331f427d7d3848
Declared pageGET modal.com/signup20058 ms
Request
GET https://modal.com/signup
Response
200 · text/html · 35329 bytes
Body
sha256:698417a8ec88528c2222e376806725abec5be11e4244300375cb4577f2589f67
Exchange
sha256:7ce674a4d84ea7913ff568bd62cfbbd6fc978b69afd29caee6c442df482cfec0
Declared pageGET modal.com/settings/usage30754 ms
Request
GET https://modal.com/settings/usage
Response
307 · application/octet-stream · 0 bytes
Body
sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
Exchange
sha256:1660b3a599526dd9d45c543da3383efe75d2db7abad6508f474d1de8b5216bea

Modal on the startup-offers board

The grade’s badge

One image that keeps itself current, linking here.

Live badge for Modal Sandboxes, agent grade: B[![agent grade](https://sourcey.com/badges/agent-readiness/arp_01m4qs72nyv8vxfvy7j6wqhj08.svg)](https://sourcey.com/c/modal/agent-readiness/modal-sandboxes/sandbox-code-run)

Improve the report

Correct it, probe it again, or improve the path.

Profile
arp_01m4qs72nyv8vxfvy7j6wqhj08
Projection
sha256:9ad9a70752dc1b56c19078c41c8fc7e217acdb8f57d515009c90af7858e3676d
Policy
kind-2026-10-12.2 · sha256:b612172aad277b54461de84e006815126f2df566563954b02f4432a39cad89ac