Netlify
Documentation Powered by ReDoc

Netlify's API documentation (2.5.0)

Download OpenAPI specification:Download

Terms of Service

Netlify is a hosting service for the programmable web. It understands your documents and provides an API to handle atomic deploys of websites, manage form submissions, inject JavaScript snippets, and much more. This is a REST-style API that uses JSON for serialization and OAuth 2 for authentication.

This document is an OpenAPI reference for the Netlify API that you can explore. For more detailed instructions for common uses, please visit the online documentation. Visit our Community forum to join the conversation about understanding and using Netlify’s API.

Additionally, we have two API clients for your convenience:

Online documentation

Authentication

netlifyAuth

Security Scheme Type OAuth2
implicit OAuth Flow
Authorization URL: https://app.netlify.com/authorize
Scopes:

    Ticket

    createTicket

    Authorizations:
    netlifyAuth
    query Parameters
    client_id
    required
    string

    Responses

    201

    ok

    default

    error

    post /oauth/tickets
    https://api.netlify.com/api/v1/oauth/tickets

    Response samples

    Content type
    application/json
    Copy
     Expand all Collapse all
    {
    • "id": "string",
    • "client_id": "string",
    • "authorized": true,
    • "created_at": "string"
    }

    showTicket

    Authorizations:
    netlifyAuth
    path Parameters
    ticket_id
    required
    string

    Responses

    200

    ok

    default

    error

    get /oauth/tickets/{ticket_id}
    https://api.netlify.com/api/v1/oauth/tickets/{ticket_id}

    Response samples

    Content type
    application/json
    Copy
     Expand all Collapse all
    {
    • "id": "string",
    • "client_id": "string",
    • "authorized": true,
    • "created_at": "string"
    }

    Access token

    exchangeTicket

    Authorizations:
    netlifyAuth
    path Parameters
    ticket_id
    required
    string

    Responses

    201

    ok

    default

    error

    post /oauth/tickets/{ticket_id}/exchange
    https://api.netlify.com/api/v1/oauth/tickets/{ticket_id}/exchange

    Response samples

    Content type
    application/json
    Copy
     Expand all Collapse all
    {
    • "id": "string",
    • "access_token": "string",
    • "user_id": "string",
    • "user_email": "string",
    • "created_at": "string"
    }

    User

    getCurrentUser

    Authorizations:
    netlifyAuth

    Responses

    200

    OK

    default

    error

    get /user
    https://api.netlify.com/api/v1/user

    Response samples

    Content type
    application/json
    Copy
     Expand all Collapse all
    [
    • {
      }
    ]

    Accounts

    listAccountsForUser

    Authorizations:
    netlifyAuth

    Responses

    200

    OK

    default

    error

    get /accounts
    https://api.netlify.com/api/v1/accounts

    Response samples

    Content type
    application/json
    Copy
     Expand all Collapse all
    [
    • {
      }
    ]

    createAccount

    Authorizations:
    netlifyAuth
    Request Body schema: application/json
    name
    required
    string
    type_id
    required
    string
    payment_method_id
    string
    period
    string
    Enum: "monthly" "yearly"
    extra_seats_block
    integer

    Responses

    201

    Created

    default

    error

    post /accounts
    https://api.netlify.com/api/v1/accounts

    Request samples

    Content type
    application/json
    Copy
     Expand all Collapse all
    {
    • "name": "string",
    • "type_id": "string",
    • "payment_method_id": "string",
    • "period": "monthly",
    • "extra_seats_block": 0
    }

    Response samples

    Content type
    application/json
    Copy
     Expand all Collapse all
    {
    • "id": "string",
    • "name": "string",
    • "slug": "string",
    • "type": "string",
    • "capabilities":
      {
      },
    • "billing_name": "string",
    • "billing_email": "string",
    • "billing_details": "string",
    • "billing_period": "string",
    • "payment_method_id": "string",
    • "type_name": "string",
    • "type_id": "string",
    • "owner_ids":
      [
      ],
    • "roles_allowed":
      [
      ],
    • "created_at": "string",
    • "updated_at": "string"
    }

    getAccount

    Authorizations:
    netlifyAuth
    path Parameters
    account_id
    required
    string

    Responses

    200

    OK

    default

    error

    get /accounts/{account_id}
    https://api.netlify.com/api/v1/accounts/{account_id}

    Response samples

    Content type
    application/json
    Copy
     Expand all Collapse all
    [
    • {