nowyourlink-com Sandbox API

The Sandbox API from nowyourlink-com — 3 operation(s) for sandbox.

Operations 3

GET /api/v1/sandbox Read a synthetic integration example; no production data or side effects #
POST /api/v1/sandbox/jobs Start a synthetic asynchronous sandbox job #
GET /api/v1/sandbox/jobs/{jobId} Read a synthetic sandbox job. Jobs always complete immediately #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/nowyourlink-com:nowyourlink-com-sandbox-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

nowyourlink-com-sandbox-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Nowyourlink Com Sandbox API
  version: 1.0.0
  description: 'Operations tagged Sandbox across 2 of this provider''s published API definitions: nowyourlink-com-openapi.json, nowyourlink-com-preview-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://nowyourlink.com
- url: https://preview.nowyourlink.com
security: []
tags:
- name: Sandbox
paths:
  /api/v1/sandbox:
    get:
      operationId: getSandboxExample
      summary: Read a synthetic integration example; no production data or side effects
      description: Read a synthetic integration example; no production data or side effects.
      security: []
      parameters: []
      responses:
        '200':
          description: Successful public read.
          headers:
            RateLimit-Policy:
              description: 'IETF draft structured field: 120-token capacity, replenished at 2 tokens per second; no fixed window.'
              schema:
                type: string
              example: '"agent";q=120;nyl-refill=2'
            RateLimit:
              description: Actual remaining tokens after this request; shared per trusted client IP across public agent endpoints.
              schema:
                type: string
              example: '"agent";r=119'
          content:
            application/json:
              schema:
                type: object
                required:
                - sandbox
                - data
                properties:
                  sandbox:
                    const: true
                  data:
                    type: object
                    additionalProperties: false
                    required:
                    - day
                    - headline
                    - description
                    - advertiser
                    - canonicalUrl
                    - contentType
                    properties:
                      day:
                        type: string
                        format: date
                        pattern: ^\d{4}-\d{2}-\d{2}$
                        description: Settled auction date in UTC, YYYY-MM-DD.
                      headline:
                        type: string
                      description:
                        type: string
                      advertiser:
                        type: string
                      canonicalUrl:
                        type: string
                        format: uri
                      contentType:
                        type: string
                        enum:
                        - paid_advertisement
                        - house_advertisement
        '400':
          description: Invalid input, unavailable content, or temporary service failure. See problem detail.
          content:
            application/problem+json:
              schema:
                type: object
                required:
                - type
                - title
                - status
                - detail
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                  detail:
                    type: string
                  docs:
                    type: string
                    format: uri
        '404':
          description: Invalid input, unavailable content, or temporary service failure. See problem detail.
          content:
            application/problem+json:
              schema:
                type: object
                required:
                - type
                - title
                - status
                - detail
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                  detail:
                    type: string
                  docs:
                    type: string
                    format: uri
        '429':
          description: Shared public token bucket exhausted. Wait Retry-After seconds before retrying.
          headers:
            RateLimit-Policy:
              description: 'IETF draft structured field: 120-token capacity, replenished at 2 tokens per second; no fixed window.'
              schema:
                type: string
              example: '"agent";q=120;nyl-refill=2'
            RateLimit:
              description: Actual remaining tokens after this request; shared per trusted client IP across public agent endpoints.
              schema:
                type: string
              example: '"agent";r=119'
            Retry-After:
              schema:
                type: integer
                minimum: 1
          content:
            application/problem+json:
              schema:
                type: object
                required:
                - type
                - title
                - status
                - detail
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                  detail:
                    type: string
                  docs:
                    type: string
                    format: uri
        '503':
          description: Invalid input, unavailable content, or temporary service failure. See problem detail.
          content:
            application/problem+json:
              schema:
                type: object
                required:
                - type
                - title
                - status
                - detail
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                  detail:
                    type: string
                  docs:
                    type: string
                    format: uri
      tags:
      - Sandbox
    servers:
    - url: https://nowyourlink.com
  /api/v1/sandbox/jobs:
    post:
      operationId: createSandboxJob
      summary: Start a synthetic asynchronous sandbox job
      description: Integration example for retry and polling logic. Requires Idempotency-Key; the same key always yields the same jobId. Never writes production data.
      security: []
      parameters:
      - name: Idempotency-Key
        in: header
        required: true
        description: Client-chosen unique key (1–255 characters). Retries with the same key return the same job.
        schema:
          type: string
          minLength: 1
          maxLength: 255
          pattern: ^[\x21-\x7e]+$
      responses:
        '202':
          description: Job accepted. Poll the Location header.
          headers:
            RateLimit-Policy:
              description: 'IETF draft structured field: 120-token capacity, replenished at 2 tokens per second; no fixed window.'
              schema:
                type: string
              example: '"agent";q=120;nyl-refill=2'
            RateLimit:
              description: Actual remaining tokens after this request; shared per trusted client IP across public agent endpoints.
              schema:
                type: string
              example: '"agent";r=119'
            Location:
              description: Job status URL.
              schema:
                type: string
                format: uri
          content:
            application/json:
              schema:
                type: object
                required:
                - sandbox
                - jobId
                - status
                - statusUrl
                properties:
                  sandbox:
                    const: true
                  jobId:
                    type: string
                    pattern: ^sbx_[0-9a-f]{16}$
                  status:
                    type: string
                    enum:
                    - queued
                    - completed
                  statusUrl:
                    type: string
                    format: uri
                  result:
                    type: object
                    required:
                    - sandbox
                    - data
                    properties:
                      sandbox:
                        const: true
                      data:
                        type: object
                        additionalProperties: false
                        required:
                        - day
                        - headline
                        - description
                        - advertiser
                        - canonicalUrl
                        - contentType
                        properties:
                          day:
                            type: string
                            format: date
                            pattern: ^\d{4}-\d{2}-\d{2}$
                            description: Settled auction date in UTC, YYYY-MM-DD.
                          headline:
                            type: string
                          description:
                            type: string
                          advertiser:
                            type: string
                          canonicalUrl:
                            type: string
                            format: uri
                          contentType:
                            type: string
                            enum:
                            - paid_advertisement
                            - house_advertisement
        '400':
          description: Invalid input. See problem detail.
          content:
            application/problem+json:
              schema:
                type: object
                required:
                - type
                - title
                - status
                - detail
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                  detail:
                    type: string
                  docs:
                    type: string
                    format: uri
        '429':
          description: Shared public token bucket exhausted. Wait Retry-After seconds before retrying.
          headers:
            RateLimit-Policy:
              description: 'IETF draft structured field: 120-token capacity, replenished at 2 tokens per second; no fixed window.'
              schema:
                type: string
              example: '"agent";q=120;nyl-refill=2'
            RateLimit:
              description: Actual remaining tokens after this request; shared per trusted client IP across public agent endpoints.
              schema:
                type: string
              example: '"agent";r=119'
            Retry-After:
              schema:
                type: integer
                minimum: 1
          content:
            application/problem+json:
              schema:
                type: object
                required:
                - type
                - title
                - status
                - detail
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                  detail:
                    type: string
                  docs:
                    type: string
                    format: uri
      tags:
      - Sandbox
    servers:
    - url: https://nowyourlink.com
  /api/v1/sandbox/jobs/{jobId}:
    get:
      operationId: getSandboxJob
      summary: Read a synthetic sandbox job. Jobs always complete immediately
      description: Read a synthetic sandbox job. Jobs always complete immediately.
      security: []
      parameters:
      - name: jobId
        in: path
        required: true
        description: Job identifier from createSandboxJob.
        schema:
          type: string
          pattern: ^sbx_[0-9a-f]{16}$
      responses:
        '200':
          description: Successful public read.
          headers:
            RateLimit-Policy:
              description: 'IETF draft structured field: 120-token capacity, replenished at 2 tokens per second; no fixed window.'
              schema:
                type: string
              example: '"agent";q=120;nyl-refill=2'
            RateLimit:
              description: Actual remaining tokens after this request; shared per trusted client IP across public agent endpoints.
              schema:
                type: string
              example: '"agent";r=119'
          content:
            application/json:
              schema:
                type: object
                required:
                - sandbox
                - jobId
                - status
                - statusUrl
                properties:
                  sandbox:
                    const: true
                  jobId:
                    type: string
                    pattern: ^sbx_[0-9a-f]{16}$
                  status:
                    type: string
                    enum:
                    - queued
                    - completed
                  statusUrl:
                    type: string
                    format: uri
                  result:
                    type: object
                    required:
                    - sandbox
                    - data
                    properties:
                      sandbox:
                        const: true
                      data:
                        type: object
                        additionalProperties: false
                        required:
                        - day
                        - headline
                        - description
                        - advertiser
                        - canonicalUrl
                        - contentType
                        properties:
                          day:
                            type: string
                            format: date
                            pattern: ^\d{4}-\d{2}-\d{2}$
                            description: Settled auction date in UTC, YYYY-MM-DD.
                          headline:
                            type: string
                          description:
                            type: string
                          advertiser:
                            type: string
                          canonicalUrl:
                            type: string
                            format: uri
                          contentType:
                            type: string
                            enum:
                            - paid_advertisement
                            - house_advertisement
        '400':
          description: Invalid input, unavailable content, or temporary service failure. See problem detail.
          content:
            application/problem+json:
              schema:
                type: object
                required:
                - type
                - title
                - status
                - detail
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                  detail:
                    type: string
                  docs:
                    type: string
                    format: uri
        '404':
          description: Invalid input, unavailable content, or temporary service failure. See problem detail.
          content:
            application/problem+json:
              schema:
                type: object
                required:
                - type
                - title
                - status
                - detail
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                  detail:
                    type: string
                  docs:
                    type: string
                    format: uri
        '429':
          description: Shared public token bucket exhausted. Wait Retry-After seconds before retrying.
          headers:
            RateLimit-Policy:
              description: 'IETF draft structured field: 120-token capacity, replenished at 2 tokens per second; no fixed window.'
              schema:
                type: string
              example: '"agent";q=120;nyl-refill=2'
            RateLimit:
              description: Actual remaining tokens after this request; shared per trusted client IP across public agent endpoints.
              schema:
                type: string
              example: '"agent";r=119'
            Retry-After:
              schema:
                type: integer
                minimum: 1
          content:
            application/problem+json:
              schema:
                type: object
                required:
                - type
                - title
                - status
                - detail
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                  detail:
                    type: string
                  docs:
                    type: string
                    format: uri
        '503':
          description: Invalid input, unavailable content, or temporary service failure. See problem detail.
          content:
            application/problem+json:
              schema:
                type: object
                required:
                - type
                - title
                - status
                - detail
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                  detail:
                    type: string
                  docs:
                    type: string
                    format: uri
      tags:
      - Sandbox
    servers:
    - url: https://nowyourlink.com
components:
  securitySchemes:
    affiliateSession:
      type: apiKey
      in: cookie
      name: nyl_sess
      description: Signed-in user session. State changes require the website Origin. Preview uses nyl_sess_preview.
    agentOAuth:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://api.nowyourlink.com/oauth/authorize
          tokenUrl: https://api.nowyourlink.com/oauth/token
          refreshUrl: https://api.nowyourlink.com/oauth/token
          scopes:
            account:read: Read account, settings and eligibility
            account:write: Update eligible company details and contact preferences
            reports:read: Read your campaign reports and Spotlight performance
            bids:read: Read own bids
            bids:write: Place and raise bids within the mandate
            creatives:read: Read own creatives
            creatives:write: Upload and submit creatives
            invoices:read: Read invoices
            billing:read: Read your saved payment methods
            billing:write: Manage your saved payment methods and billing portal
            security:read: Read your registered passkeys
            security:write: Remove your registered passkeys
            privacy:write: Request data export or account erasure
            connections:read: Read your authorized agent connections
            connections:write: Revoke your authorized agent connections
            affiliate:read: Read own partner statistics, referral links and payouts
            affiliate:write: Configure own callback and request commission payouts
x-refined-from:
- nowyourlink-com-openapi.json
- nowyourlink-com-preview-openapi.json