Provider Auth Methods

An auth method defines one way to authenticate with a provider (OAuth, API token, or custom credentials). A provider version may support multiple auth methods.

Provider Auth Methods object

Attributes

object

String

String representing the object's type

id

String

Unique auth method identifier

type

Enum

Authentication type

name

String

Display name

description

StringNullable

Auth method description

input_schema

ObjectNullable

JSON Schema defining the required auth input fields. Contains standard JSON Schema fields like type, properties, required, etc.

scopes

ObjectNullable

Available OAuth scopes

provider_id

String

Provider ID

provider_specification_id

String

Specification ID

created_at

Date

Timestamp when created

updated_at

Date

Timestamp when last updated

{
  "object": "provider.auth_method",
  "id": "pam_2mNpQrStUvWxYzAb",
  "type": "oauth",
  "name": "OAuth 2.0",
  "description": "Authenticate using OAuth 2.0",
  "input_schema": {
    "type": "object",
    "properties": {
      "client_id": {
        "type": "string",
        "description": "OAuth client ID"
      },
      "client_secret": {
        "type": "string",
        "description": "OAuth client secret"
      }
    },
    "required": [
      "client_id",
      "client_secret"
    ]
  },
  "scopes": [
    {
      "object": "provider.auth_method.scope",
      "id": "pams_8tUvWxYzAbCdEfGh",
      "scope": "repo",
      "name": "Repository Access",
      "description": "Full control of private repositories"
    }
  ],
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "provider_specification_id": "psp_9gHjKlMnPqRsTuVw",
  "created_at": "2025-09-15T10:30:00.000Z",
  "updated_at": "2026-01-10T14:45:00.000Z"
}

List provider auth methods

Returns a paginated list of provider auth methods.

URL Parameters

provider_id

String

The unique identifier for the provider

Query Parameters

limit

NumberOptional

Maximum number of items to return (1-100)

after

StringOptional

Return items after this ID

before

StringOptional

Return items before this ID

cursor

StringOptional

Pagination cursor from a previous response

order

EnumOptional

Sort order for results

provider_version_id

StringOptional
GEThttp://api.metorial.com/providers/:provider_id/auth-methods
curl -X GET "https://api.metorial.com/providers/pro_Rm4Mnheq2bfEPhBhP7SY/auth-methods" \
  -H "Authorization: Bearer metorial_sk_..."

Get provider auth method

Retrieves a specific provider auth method by ID.

URL Parameters

provider_id

String

The unique identifier for the provider

provider_auth_method_id

String

The unique identifier for the provider_auth_method

GEThttp://api.metorial.com/providers/:provider_id/auth-methods/:provider_auth_method_id
curl -X GET "https://api.metorial.com/providers/pro_Rm4Mnheq2bfEPhBhP7SY/auth-methods/pro_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."