> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Sumble Teams: Inputs, Cost & CLI Example
> Unified teams endpoint. Requires the workspace's own Sumble API key. Sumble Sumble Teams docs include request fields, response shape, pricing notes, and
## Run in Enrichment Spreadsheet
Use this function as a column step in `deepline enrich`.
```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=sumble_teams:{"select":{}}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| ---------------------------- | ---------------------------------------------------------------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------- |
| `payload.teams` | `array` | No | | List of Sumble team ids to retrieve and enrich. One result row per entry, in input order. Mutually exclusive with `filter`. |
| `payload.filter` | `object` | No | | Query selecting the teams to return. Mutually exclusive with `teams`. |
| `payload.select` | `object` | Yes | | |
| `payload.limit` | `integer` | No | `10` | Maximum number of teams to return (filter mode only; ignored when `teams` is provided). |
| `payload.offset` | `integer` | No | `0` | Number of results to skip (filter mode only; ignored when `teams` is provided). |
| `payload.order_by_column` | `"jobs_count" \| "first_activity" \| "last_activity" \| "score"` | No | | Column to order by (filter mode only): `jobs_count`, `first_activity` or `last_activity`. Default: jobs\_count. |
| `payload.order_by_direction` | `"ASC" \| "DESC"` | No | | Sort direction; DESC when omitted. |
### Allowed values
| Field | Allowed values |
| ---------------------------- | -------------------------------------------------------- |
| `payload.order_by_column` | `jobs_count`, `first_activity`, `last_activity`, `score` |
| `payload.order_by_direction` | `ASC`, `DESC` |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Unified teams endpoint",
"properties": {
"teams": {
"type": [
"array",
"null"
],
"description": "List of Sumble team ids to retrieve and enrich. One result row per entry, in input order. Mutually exclusive with `filter`.",
"minItems": 1,
"maxItems": 1000,
"items": {
"type": "integer"
}
},
"filter": {
"type": [
"object",
"null"
],
"description": "Query selecting the teams to return. Mutually exclusive with `teams`.",
"properties": {
"organization_ids": {
"type": "array",
"description": "Sumble organization ids to search within. Teams are returned for these organizations only — no parent/subsidiary roll-up. Unknown ids simply match no teams.",
"minItems": 1,
"maxItems": 1000,
"items": {
"type": "integer"
}
},
"query": {
"type": [
"object",
"null"
],
"description": "Advanced query narrowing the teams returned (technologies, technology categories, job functions, hiring period).",
"properties": {
"query": {
"type": "string"
}
},
"required": [
"query"
],
"additionalProperties": false
},
"since": {
"type": [
"string",
"null"
],
"description": "Only count activity (jobs_count, first/last activity) on or after this date (YYYY-MM-DD). Does not affect the aggregated technology / job-function / location lists, which are all-time."
}
},
"required": [
"organization_ids"
],
"additionalProperties": false
},
"select": {
"type": "object",
"properties": {
"attributes": {
"description": "Team attributes to include, or 'all' for every available attribute. Off by default. 'all' includes `score` only when it is available (an ICP configured for your account) — otherwise it is skipped, not an error. Note that 'all' grows — and its cost grows — as new attributes are added to the endpoint.",
"default": [],
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"enum": [
"organization",
"breadcrumbs",
"jobs_count",
"technology_list",
"job_function_list",
"location_list",
"first_activity",
"last_activity",
"score"
]
}
},
{
"type": "string",
"const": "all"
}
]
},
"related_people": {
"type": [
"object",
"null"
],
"description": "Also return the people associated with each team, with a person-team match score. Available in both modes. Each related person returned costs 1 credit.",
"properties": {
"attributes": {
"description": "Person-level attributes to include for each related person, or 'all' for every attribute available here. Contact attributes (email, phone) and `person_score` are not available here; `confidence` (the person-team match score breakdown) is only available here.",
"default": [],
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"enum": [
"name",
"email",
"phone",
"linkedin_url",
"job_title",
"job_function",
"job_level",
"location",
"country",
"current_employer",
"technologies",
"person_score",
"confidence"
]
}
},
{
"type": "string",
"const": "all"
}
]
},
"max_per_team": {
"type": "integer",
"description": "Maximum related people returned per team.",
"default": 10,
"minimum": 1,
"maximum": 100
}
},
"additionalProperties": false
},
"job_posts": {
"type": [
"object",
"null"
],
"description": "Also return the job postings mentioning each team, with composable job components. Each job posting returned costs 1 credit.",
"properties": {
"components": {
"description": "Job components to return per posting, or 'all' for every available component. Mirrors the unified jobs endpoint: `job_details` (title, location, posted date), `technologies`, `job_functions`, `job_level`. Never includes the full description (fetch that from the jobs endpoint with the returned job ids).",
"default": [],
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"enum": [
"job_details",
"technologies",
"job_functions",
"job_level"
]
}
},
{
"type": "string",
"const": "all"
}
]
},
"max_per_team": {
"type": "integer",
"description": "Maximum job postings returned per team.",
"default": 10,
"minimum": 1,
"maximum": 100
},
"since": {
"type": [
"string",
"null"
],
"description": "Only return job postings pulled on or after this date (YYYY-MM-DD)."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"limit": {
"type": "integer",
"description": "Maximum number of teams to return (filter mode only; ignored when `teams` is provided).",
"default": 10,
"minimum": 1,
"maximum": 200
},
"offset": {
"type": "integer",
"description": "Number of results to skip (filter mode only; ignored when `teams` is provided).",
"default": 0,
"minimum": 0,
"maximum": 10000
},
"order_by_column": {
"type": [
"string",
"null"
],
"description": "Column to order by (filter mode only): `jobs_count`, `first_activity` or `last_activity`. Default: jobs_count.",
"enum": [
"jobs_count",
"first_activity",
"last_activity",
"score"
]
},
"order_by_direction": {
"type": [
"string",
"null"
],
"description": "Sort direction; DESC when omitted.",
"enum": [
"ASC",
"DESC"
]
}
},
"required": [
"select"
],
"additionalProperties": false
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes | | Provider response payload. |
| `result.meta` | `object` | No | | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"description": "Standard tool result payload.",
"properties": {
"data": {
"type": "object",
"description": "Provider response payload.",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"teams": {
"type": "array",
"items": {
"type": "object",
"properties": {
"input": {
"type": [
"integer",
"null"
],
"description": "The input team id this row corresponds to (list mode only)."
},
"team_id": {
"type": [
"integer",
"null"
],
"description": "Absent when the input id didn't match a Sumble team."
},
"name": {
"type": [
"string",
"null"
]
},
"sumble_url": {
"type": [
"string",
"null"
],
"description": "Link to the team's Sumble page.",
"minLength": 1,
"maxLength": 2083,
"format": "uri"
},
"attributes": {
"type": [
"object",
"null"
],
"description": "The requested team attributes; absent when none are requested.",
"properties": {
"organization": {
"type": [
"object",
"null"
],
"properties": {
"organization_id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
},
"sumble_url": {
"type": [
"string",
"null"
],
"description": "Link to the organization's Sumble profile page.",
"minLength": 1,
"maxLength": 2083,
"format": "uri"
}
},
"required": [
"organization_id"
],
"additionalProperties": false
},
"breadcrumbs": {
"type": [
"array",
"null"
],
"description": "Parent-team chain from the root to this team.",
"items": {
"type": "object",
"properties": {
"team_id": {
"type": [
"integer",
"null"
]
},
"name": {
"type": "string"
},
"slug": {
"type": [
"string",
"null"
]
},
"sumble_url": {
"type": [
"string",
"null"
],
"description": "Link to the ancestor team's Sumble page.",
"minLength": 1,
"maxLength": 2083,
"format": "uri"
}
},
"required": [
"name"
],
"additionalProperties": false
}
},
"jobs_count": {
"type": [
"integer",
"null"
]
},
"technology_list": {
"type": [
"array",
"null"
],
"description": "Technologies the team uses, aggregated from its job postings (all-time).",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"used": {
"type": "boolean",
"description": "True when the team's postings indicate the technology is used, not merely mentioned.",
"default": false
},
"jobs_count": {
"type": [
"integer",
"null"
],
"description": "Job postings mentioning this technology for the team."
}
},
"required": [
"name",
"slug"
],
"additionalProperties": false
}
},
"job_function_list": {
"type": [
"array",
"null"
],
"description": "Job functions the team hires for, aggregated from its job postings (all-time).",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"jobs_count": {
"type": [
"integer",
"null"
],
"description": "Job postings hiring for this job function for the team."
}
},
"required": [
"name",
"slug"
],
"additionalProperties": false
}
},
"location_list": {
"type": [
"array",
"null"
],
"description": "Locations where the team operates, derived from its job postings (all-time).",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"jobs_count": {
"type": [
"integer",
"null"
],
"description": "Job postings for the team in this location."
}
},
"required": [
"name"
],
"additionalProperties": false
}
},
"first_activity": {
"type": [
"string",
"null"
],
"description": "Earliest job posting mentioning the team.",
"format": "date-time"
},
"last_activity": {
"type": [
"string",
"null"
],
"description": "Latest job posting mentioning the team.",
"format": "date-time"
},
"score": {
"type": [
"object",
"null"
],
"description": "Sumble team score against your ICP, 0-100. Returned only when an ICP is configured for your account (`attributes: \"all\"` skips it otherwise instead of erroring).",
"properties": {
"value": {
"type": "number",
"description": "How well the team matches your ideal customer profile (ICP), 0-100."
},
"fit": {
"type": [
"string",
"null"
],
"description": "Qualitative fit bucket (e.g. 'Great', 'Good', 'Possible')."
},
"components": {
"type": "array",
"description": "The matched features behind the score, highest contribution first.",
"default": [],
"items": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
},
"match_type": {
"type": "string"
},
"contribution": {
"type": "number",
"description": "Points of the 0-100 score attributable to this feature."
}
},
"required": [
"match_type",
"contribution"
],
"additionalProperties": false
}
}
},
"required": [
"value"
],
"additionalProperties": false
}
},
"additionalProperties": false
},
"related_people": {
"type": [
"array",
"null"
],
"description": "People associated with the team. Present (possibly empty) when `select.related_people` is requested and the team matched; absent otherwise.",
"items": {
"type": "object",
"properties": {
"person_id": {
"type": "integer"
},
"sumble_url": {
"type": "string",
"description": "Link to the person's Sumble profile page.",
"minLength": 1,
"maxLength": 2083,
"format": "uri"
},
"confidence": {
"type": [
"object",
"null"
],
"description": "Why this person was returned: person-team match score with a per-feature breakdown. Present when the `confidence` attribute is requested.",
"properties": {
"score": {
"type": "number",
"description": "How strongly this person relates to the team, based on shared team, job-function, technology, location and title-embedding signals. Unrelated to the ICP-based team `score` attribute."
},
"matched_features": {
"type": "array",
"description": "The specific matched features behind the score.",
"default": [],
"items": {
"type": "object",
"properties": {
"match_type": {
"type": "string",
"enum": [
"team",
"job_function",
"technology",
"location",
"embedding"
]
},
"name": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
},
"is_parent": {
"type": "boolean",
"default": false
},
"score": {
"type": "number",
"description": "Share of the match score attributable to this feature."
}
},
"required": [
"match_type",
"score"
],
"additionalProperties": false
}
}
},
"required": [
"score"
],
"additionalProperties": false
},
"attributes": {
"type": [
"object",
"null"
],
"description": "The requested person-level attributes; absent when none resolve.",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"email": {
"type": [
"string",
"null"
],
"description": "Revealed work email (match mode only). The first successful reveal per person costs 10 credits; repeat reveals while active are free."
},
"phone": {
"type": [
"string",
"null"
],
"description": "Revealed phone number (match mode only). The first successful reveal per person costs 80 credits; repeat reveals while active are free."
},
"linkedin_url": {
"type": [
"string",
"null"
],
"minLength": 1,
"maxLength": 2083,
"format": "uri"
},
"job_title": {
"type": [
"string",
"null"
]
},
"job_function": {
"type": [
"string",
"null"
]
},
"job_level": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
},
"current_employer": {
"type": [
"object",
"null"
],
"properties": {
"organization_id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
},
"start_date": {
"type": [
"string",
"null"
],
"description": "Start of the person's current role (YYYY-MM)."
},
"sumble_url": {
"type": [
"string",
"null"
],
"description": "Link to the organization's Sumble profile page.",
"minLength": 1,
"maxLength": 2083,
"format": "uri"
}
},
"required": [
"organization_id"
],
"additionalProperties": false
},
"technologies": {
"type": [
"array",
"null"
],
"description": "Technologies from the skills on the person's LinkedIn profile, normalized to Sumble's technology catalog. The slug can be used in `filter.query` (technology EQ ' '). Empty when none of the profile's skills map to a known technology.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"name",
"slug"
],
"additionalProperties": false
}
},
"person_score": {
"type": [
"object",
"null"
],
"description": "How well the person matches your ideal customer profile (ICP), 0-100, with a per-feature breakdown. Priced like other paid attributes. Filter mode only; selecting it explicitly requires the filter to resolve to exactly one organization and an ICP configured for your account (`attributes: \"all\"` skips it instead when unavailable). Included automatically when sorting with `order_by_column=\"person_score\"`.",
"properties": {
"value": {
"type": "number",
"description": "How well the person matches your ideal customer profile (ICP), 0-100. Sum of the three contributions below."
},
"skill_contribution": {
"type": "number",
"description": "Points from technologies the person uses that match your ICP."
},
"job_function_contribution": {
"type": "number",
"description": "Points from the person's job function matching your ICP."
},
"seniority_contribution": {
"type": "number",
"description": "Points from the person's job level (seniority)."
},
"matched_features": {
"type": "array",
"description": "The matched technologies and job functions behind the skill and job-function contributions, highest contribution first.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"match_type": {
"type": "string",
"enum": [
"technology",
"job_function"
]
},
"contribution": {
"type": "number",
"description": "Points of the 0-100 score attributable to this feature."
}
},
"required": [
"name",
"slug",
"match_type",
"contribution"
],
"additionalProperties": false
}
}
},
"required": [
"value",
"skill_contribution",
"job_function_contribution",
"seniority_contribution",
"matched_features"
],
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"required": [
"person_id",
"sumble_url"
],
"additionalProperties": false
}
},
"job_posts": {
"type": [
"array",
"null"
],
"description": "Job postings mentioning the team. Present (possibly empty) when `select.job_posts` is requested and the team matched; absent otherwise.",
"items": {
"type": "object",
"properties": {
"job_id": {
"type": "integer"
},
"sumble_url": {
"type": [
"string",
"null"
],
"description": "Link to the job posting's Sumble page.",
"minLength": 1,
"maxLength": 2083,
"format": "uri"
},
"attributes": {
"type": [
"object",
"null"
],
"description": "The requested job components; absent when none are requested.",
"properties": {
"title": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"posted_date": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"organization": {
"type": [
"object",
"null"
],
"properties": {
"organization_id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
},
"domain": {
"type": [
"string",
"null"
]
},
"sumble_url": {
"type": [
"string",
"null"
],
"description": "Link to the organization's Sumble profile page.",
"minLength": 1,
"maxLength": 2083,
"format": "uri"
}
},
"required": [
"organization_id"
],
"additionalProperties": false
},
"technologies": {
"type": [
"array",
"null"
],
"description": "All technologies extracted from the posting; empty list when requested but none were extracted.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"used": {
"type": "boolean",
"description": "True when the posting indicates the technology is used by the team, not merely mentioned."
},
"sumble_url": {
"type": [
"string",
"null"
],
"description": "The posting organization's jobs page filtered to this technology.",
"minLength": 1,
"maxLength": 2083,
"format": "uri"
}
},
"required": [
"name",
"slug",
"used"
],
"additionalProperties": false
}
},
"teams": {
"type": [
"array",
"null"
],
"description": "Teams extracted from the posting; empty list when requested but none were extracted.",
"items": {
"type": "object",
"properties": {
"team_id": {
"type": "integer"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"sumble_url": {
"type": [
"string",
"null"
],
"description": "Link to the team's Sumble page.",
"minLength": 1,
"maxLength": 2083,
"format": "uri"
}
},
"required": [
"team_id",
"name",
"slug"
],
"additionalProperties": false
}
},
"job_functions": {
"type": [
"array",
"null"
],
"description": "Job functions classified from the posting; empty list when requested but none were classified.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"sumble_url": {
"type": [
"string",
"null"
],
"description": "The posting organization's jobs page filtered to this job function.",
"minLength": 1,
"maxLength": 2083,
"format": "uri"
}
},
"required": [
"name",
"slug"
],
"additionalProperties": false
}
},
"job_levels": {
"type": [
"array",
"null"
],
"description": "Seniority levels classified from the posting; empty list when requested but none were classified.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
}
},
"required": [
"name"
],
"additionalProperties": false
}
},
"projects": {
"type": [
"array",
"null"
],
"description": "Projects extracted from the posting; empty list when requested but none were extracted.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"goal": {
"type": [
"string",
"null"
]
},
"sumble_url": {
"type": [
"string",
"null"
],
"description": "The posting organization's jobs page filtered to this project.",
"minLength": 1,
"maxLength": 2083,
"format": "uri"
}
},
"required": [
"name",
"slug"
],
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"required": [
"job_id"
],
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"matched_count": {
"type": [
"integer",
"null"
],
"description": "List mode only: how many input ids matched a Sumble team."
},
"total": {
"type": "integer"
},
"source_data_url": {
"type": [
"string",
"null"
],
"minLength": 1,
"maxLength": 2083,
"format": "uri"
}
},
"required": [
"id",
"teams",
"total"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"description": "Additional response metadata (status, paging).",
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## Advanced: Direct CLI
Use direct execution for single payload debugging.
```bash theme={null}
deepline tools execute sumble_teams --payload '{
"select": {}
}' --json
```
### CLI flags
| Flag | Description |
| --------------------------- | --------------------------------------------------- |
| `--json` | Print machine-readable output. |
| `--wait` | Wait for terminal provider status when supported. |
| `--debug` | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS` | Max seconds to wait in wait mode. |
| `--poll-interval SECONDS` | Polling interval in seconds during wait mode. |
| `--timeout SECONDS` | Request timeout in seconds. |
| `--connect-timeout SECONDS` | Connection timeout in seconds. |
## Cost
* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
* Billing mode: `no_bill`.