Skip to main content
GET
/
api
/
v1
/
services
/
{service_id}
Python (SDK)
import os
from syllable_sdk import SyllableSDK


with SyllableSDK(
    api_key_header=os.getenv("SYLLABLESDK_API_KEY_HEADER", ""),
) as ss_client:

    res = ss_client.services.get_by_id(service_id=902529)

    # Handle response
    print(res)
{
  "id": 1,
  "name": "Weather tools",
  "description": "Service containing tools for fetching weather information",
  "auth_type": "basic",
  "auth_value_keys": [
    "username",
    "password"
  ],
  "last_updated_comments": "Updated description to correct typo",
  "last_updated": "2024-01-01T12:00:00Z",
  "last_updated_by": "user@email.com",
  "tools": [
    "hangup",
    "summary"
  ]
}

Authorizations

Syllable-API-Key
string
header
required

Path Parameters

service_id
integer
required

Response

Successful Response

Response model for service operations. A service is a collection of tools.

id
integer
required

The internal ID of the service

Examples:

1

name
string
required

The name of the service

Examples:

"Weather tools"

description
string
required

The description of the service

Examples:

"Service containing tools for fetching weather information"

last_updated
string<date-time>
required

The timestamp of the most recent update to the service

Examples:

"2024-01-01T12:00:00Z"

last_updated_by
string
required

The email of the user who last updated the service

Examples:

"user@email.com"

tools
string[]
required

Names of tools that belong to the service

Examples:
["hangup", "summary"]
auth_type
enum<string> | null

The type of authentication to use for the service's tools

Available options:
basic,
bearer,
custom_headers,
oauth2
Examples:

"basic"

auth_value_keys
string[] | null

Auth value keys (values omitted for security)

Examples:
["username", "password"]
last_updated_comments
string | null

Free text providing comment about what was updated

Examples:

"Updated description to correct typo"

I