SKskyfire

Create Agent's Service

Changed on

Create a seller service that belongs to an agent.

post/api/v1/agents/seller-services

Request

  • Base URL
    https://api.skyfire.xyz
  • URL
    https://api.skyfire.xyz/api/v1/agents/seller-services
  • Auth
    API key in header skyfire-api-key

Request body

namestring required

The name of the service.

descriptionstring required

The description of the service.

tagsstring[] required

The tags for this service. An empty array is fine.

type'API' | 'WEB_PAGE' | 'MCP_SERVER_REMOTE' | 'MCP_SERVER_LOCAL' | 'FETCH_AGENT' required

The type of the service. This is one of: "API", "WEB_PAGE", "MCP_SERVER_REMOTE", "MCP_SERVER_LOCAL", or "FETCH_AGENT"

pricestring required

Price of the service in USD.

priceModel'PAY_PER_USE' | 'SUBSCRIPTION' | 'PAY_PER_MB' | 'CUSTOM' required

The pricing model of the service. This is one of "PAY_PER_USE", "SUBSCRIPTION", "PAY_PER_MB", or "CUSTOM".

minimumTokenAmountstring required

Buyers must create tokens of at least this amount in USD.

mcpServerUrlstring

The URL of the MCP Server for this service. This is required if the "type" is "MCP_SERVER_REMOTE" or "MCP_SERVER_LOCAL".

openApiSpecUrlstring

The URL of the OpenAPI specification for this service. This is required if the "type" is "API".

websiteUrlstring

The URL of the website. This is required if the "type" is "WEB_PAGE".

fetchAgentProfileUrlstring

The URL of the Fetch.ai agent. This is required if the "type" is "FETCH_AGENT".

acceptedTokensstring[]

Must be one or more of "kya", "pay" and "kya-pay". Must not be an empty array. If this field is omitted then all token types will be accepted.

maxTokenTTLSecondsnumber

Maximum token TTL in seconds between 10s and 24hr.

Response

Ok

idstring required

Unique identifier of the seller service.

namestring required

The name of the service.

descriptionstring required

The description of the service.

tagsstring[] required

The tags for this service. Empty if none were set.

type'API' | 'WEB_PAGE' | 'VERIFIED_DOMAIN' | 'MCP_SERVER_LOCAL' | 'MCP_SERVER_REMOTE' | 'FETCH_AGENT' required

One of "API", "WEB_PAGE", "VERIFIED_DOMAIN", "MCP_SERVER_LOCAL", "MCP_SERVER_REMOTE", or "FETCH_AGENT"

pricestring required

USD as string. For priceModel: CUSTOM, use "0".

priceModel'PAY_PER_USE' | 'SUBSCRIPTION' | 'PAY_PER_MB' | 'CUSTOM' required

One of "PAY_PER_USE", "SUBSCRIPTION", "PAY_PER_MB", or "CUSTOM"

minimumTokenAmountstring required

USD as string. For CUSTOM, use "0". Must be ≥ price after numeric conversion.

openApiSpecUrlstring

Required when type is API.

websiteUrlstring

Required when type is WEB_PAGE.

fetchAgentProfileUrlstring

Required when type is FETCH_AGENT.

mcpServerUrlstring

Required when type is MCP_SERVER_LOCAL or MCP_SERVER_REMOTE.

acceptedTokensstring[]

Any of "kya", "pay", and/or "kya-pay". Must not be an empty array. If field is omitted, then all token types are accepted.

maxTokenTTLSecondsnumber

Maximum token TTL in seconds.

createdAtstring required

When the service was created. e.g. "2025-07-18T02:51:54.265Z".

updatedAtstring required

When the service was last updated. e.g. "2025-07-18T02:54:19.767Z".

activeboolean required

Whether the service is active.

approvedboolean required

Whether the service has been approved. Only approved services can be activated.

Changes

  • 22cbec9d7630Revision changes
    • breaking

      request body became required

    • breaking

      request property / was restricted to a list of enum values

    • breaking

      request property was restricted to a list of enum values

    • breaking

      request property was restricted to a list of enum values

    • warning

      added the new API enum value to the response property for the response status

    • warning

      added the new CUSTOM enum value to the response property for the response status

    • warning

      added the new FETCH_AGENT enum value to the response property for the response status

    • warning

      added the new MCP_SERVER_LOCAL enum value to the response property for the response status

    • warning

      added the new MCP_SERVER_REMOTE enum value to the response property for the response status

    • warning

      added the new PAY_PER_MB enum value to the response property for the response status

    • warning

      added the new PAY_PER_USE enum value to the response property for the response status

    • warning

      added the new SUBSCRIPTION enum value to the response property for the response status

    • warning

      added the new VERIFIED_DOMAIN enum value to the response property for the response status

    • warning

      added the new WEB_PAGE enum value to the response property for the response status

    • warning

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

    • warning

      added the new kya-pay enum value to the / response property for the response status

    • warning

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

    • info

      added the new API enum value to the request property

    • info

      added the new CUSTOM enum value to the request property

    • info

      added the new FETCH_AGENT enum value to the request property

    • info

      added the new MCP_SERVER_LOCAL enum value to the request property

    • info

      added the new MCP_SERVER_REMOTE enum value to the request property

    • info

      added the new PAY_PER_MB enum value to the request property

    • info

      added the new PAY_PER_USE enum value to the request property

    • info

      added the new SUBSCRIPTION enum value to the request property

    • info

      added the new WEB_PAGE enum value to the request property

    • info

      added the new kya enum value to the request property /

    • info

      added the new kya-pay enum value to the request property /

    • info

      added the new pay enum value to the request property /

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status