Resources

Get Resource

Changed on

Retrieves a Fabric resource from your SignalWire project without requiring its type in advance. The response identifies what the resource is; use that resource type's own get operation when you need its full configuration.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Voice, Messaging, Fax, or Video.

Learn more about API scopes.

get/api/fabric/resources/{id}

Request

  • Base URL
    https://{Your_Space_Name}.signalwire.com
  • URL
    https://{Your_Space_Name}.signalwire.com/api/fabric/resources/{id}
  • Auth
    HTTP basic

Path parameters

idstring uuid required

Universal Unique Identifier.

Unique ID of a Resource.

Response

The request has succeeded.

OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR

Example response

{
  "display_name": "My Resource",
  "created_at": "2024-05-06T12:20:00Z",
  "updated_at": "2024-05-06T12:20:00Z",
  "type": "ai_agent",
  "ai_agent": {
    "hints": [
      "pizza",
      "pepperoni"
    ],
    "languages": [
      {
        "name": "English",
        "code": "en-US",
        "voice": "rime.spore"
      }
    ],
    "params": {
      "ai_model": "gpt-4o-mini",
      "wait_for_user": true
    },
    "post_prompt": {
      "text": "Summarize the conversation and provide any follow-up action items."
    },
    "pronounce": [
      {
        "replace": "SWML",
        "with": "swim-el",
        "ignore_case": true
      }
    ],
    "prompt": {
      "text": "You are a helpful customer support assistant."
    },
    "SWAIG": {
      "native_functions": [
        "check_time"
      ]
    },
    "name": "My AI Agent"
  }
}

Changes

  • 3ce00e9f8aa1Revision changes
    • breaking

      added to the response body oneOf list for the response status

  • 173ff877e9cdRevision changes
    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • info

      response property oneOf[subschema #1: AI Agent]/ai_agent/allOf[subschema #1: AI Agent]/hints/items/ list-of-types was narrowed by removing types object from media type application/json of response 200

Some revisions have not been checked yet.