Resources

List resources

Changed on

Cursor-paginated list of the workspace's provider resources (durable, workspace-owned provider assets, e.g. phone numbers), newest first. Optional provider/resourceType/state filters (resourceType requires provider). Three listing modes: by default the page holds TOP-LEVEL resources only; includeChildren=true lists everything (children included) in one flat page; parent=<id> lists ONLY that resource's children.

get/v1/resources

Request

  • Base URL: https://api.monid.ai
  • URL: https://api.monid.ai/v1/resources
  • Auth: HTTP bearer

Query parameters

limitinteger

Max items per page (server-side cap applies).

cursorstring

Cursor returned by the previous page.

provider'apify' | 'pdl' | 'opoint' | 'tikhub' | 'exa' | 'minimax' | 'bytedance' | 'suzanne' | 'akta' | 'saperly' | 'apollo' | 'censusdata.xyz' | 'defillama' | 'sfs' | 'semrush' | 'elevenlabs' | 'octen' | 'mint' | 'context.dev' | 'surf' | 'agentmail' | 'ahrefs' | 'tinyfish' | 'firecrawl' | 'massive' | 'hunterio' | 'contactout' | 'clay' | 'alibaba' | 'mrscraper' | 'fundable' | 'ploid' | 'smolmachine' | 'kling' | 'recall' | 'gemini' | 'tendata' | 'openai' | 'vaquill' | 'litescrape' | 'typesafe' | 'dataforseo' | 'orbit' | 'cloro' | 'topaz' | 'search1api' | 'magichour' | 'agentline' | 'keenable' | 'datalegion' | 'anyapi' | 'fishaudio'

Filter by provider slug (e.g. 'saperly').

resourceType'phone_number' | 'file_system' | 'asset_library' | 'machine' | 'email_account' | 'email_inbox' | 'email_domain' | 'browser_session' | 'browser_profile' | 'voice'

Filter by resource type — requires provider (store SK prefix is ordered).

state'READY' | 'PROVISIONING' | 'ACTIVE' | 'EXPIRING' | 'SUSPENDED' | 'RELEASED' | 'PROVISION_FAILED'

Filter by lifecycle state.

parentstring

List ONLY the children of this resource (e.g. an email account's inboxes) instead of the workspace's top-level resources. 404 when the resource is not yours. Mutually exclusive with includeChildren.

includeChildren'true' | 'false'

Include child resources (e.g. the inboxes inside an email account) in the flat workspace listing. Default: top-level resources only. Mutually exclusive with parent.

Headers

X-Monid-Agent-Modelstring

Model driving the calling agent. Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

X-Monid-Agent-Harnessstring

Agent harness or client making the call (e.g. a coding agent, an agent framework). Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

X-Monid-Agent-Session-Idstring

Caller-side session identifier, so the calls of one agent session (discover → inspect → run → polling) can be correlated. Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

Response

Resources page

cursorstring

Opaque cursor for the next page; absent on the last page.

Changes

  • 47b1a281e325Revision changes
    • warning

      added the new byte enum value to the ////// response property for the response status

    • warning

      added the new byte enum value to the //////// response property for the response status

    • warning

      added the new byte enum value to the //// response property for the response status

    • warning

      added the new byte enum value to the //////// response property for the response status

    • info

      added the new enum value fishaudio to the query request parameter provider

    • info

      added the new enum value voice to the query request parameter resourceType

  • 631143e91790Revision changes
    • info

      added the new optional header request parameter X-Monid-Agent-Harness

    • info

      added the new optional header request parameter X-Monid-Agent-Model

    • info

      added the new optional header request parameter X-Monid-Agent-Session-Id

    • info

      removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status

    • info

      removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status

    • info

      removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status

    • info

      removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status

    • info

      removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status

    • info

      removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status