> ## Documentation Index > Fetch the complete documentation index at: https://docs.b2bsignals.ai/llms.txt > Use this file to discover all available pages before exploring further. # See what needs you > What this campaign is waiting on: approvals, replies, failures, senders. ## OpenAPI ````yaml /api/openapi.json get /workflows/{workflow_id}/needs-you openapi: 3.1.0 info: title: B2B Signals API version: '1.0' description: >- Add people, run campaigns and read results from your own tools. Every request needs your API key in the `X-API-Key` header. servers: - url: https://api.b2bsignals.ai/api/v1 security: - apiKey: [] tags: - name: Add people description: >- Send people in from your own tools, one at a time or up to 100 per request. - name: People description: >- Read and change the people in your workspace. In API paths and fields, a person is a `lead`. - name: Notes and tasks description: Notes on a person, and follow-up tasks. - name: Lists description: >- Named groups of people you can add to a campaign. In API paths, a list is a `lead-list`. - name: Campaigns description: >- Read, start, pause and report on campaigns. In API paths and fields, a campaign is a `workflow`. - name: Campaign people description: >- One person's place in one campaign. In API paths and fields, that is a `workflow-run`. - name: Approvals description: Messages waiting for a yes or no before they go out. - name: Inbox description: Read conversations and keep them organized. - name: Do not contact description: People and companies that must never be contacted. - name: Senders description: >- The LinkedIn accounts that send for your workspace. In API paths, a sender is a `connected-account`. - name: Webhooks description: Send events to your own tools. - name: Integrations description: See which outside tools are connected, and send people to them. - name: Reports description: The numbers behind Reports, and exports. - name: Watchlists description: Read the companies and people you watch. - name: Search description: Search across people, campaigns, lists and watchlists. paths: /workflows/{workflow_id}/needs-you: get: tags: - Campaigns summary: See what needs you description: 'What this campaign is waiting on: approvals, replies, failures, senders.' operationId: get_workflows_workflow_id_needs_you parameters: - name: workflow_id in: path required: true schema: type: string format: uuid responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/NeedsYouResponse' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '422': description: The request did not pass validation. content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: NeedsYouResponse: properties: primary: anyOf: - type: string enum: - sender - to_approve - send_by_hand - failed - replies - invites - type: 'null' to_approve: $ref: '#/components/schemas/NeedsYouApprove' send_by_hand: $ref: '#/components/schemas/NeedsYouCount' invites: $ref: '#/components/schemas/NeedsYouCount' replies: $ref: '#/components/schemas/NeedsYouReplies' failed: $ref: '#/components/schemas/NeedsYouFailed' sender_problems: items: $ref: '#/components/schemas/NeedsYouSenderProblem' type: array type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array type: object NeedsYouApprove: properties: count: type: integer default: 0 first_due_at: anyOf: - type: string format: date-time - type: 'null' type: object NeedsYouCount: properties: count: type: integer default: 0 type: object NeedsYouReplies: properties: count: type: integer default: 0 people: items: $ref: '#/components/schemas/NeedsYouPerson' type: array type: object NeedsYouFailed: properties: count: type: integer default: 0 groups: items: $ref: '#/components/schemas/NeedsYouFailedGroup' type: array run_ids: items: type: string format: uuid type: array type: object NeedsYouSenderProblem: properties: sender_account_id: type: string format: uuid sender_name: anyOf: - type: string - type: 'null' label: type: string people_waiting: type: integer default: 0 type: object required: - sender_account_id - label Error: type: object required: - detail properties: detail: description: A message, or an object with a `code` and a `message`. anyOf: - type: string - type: object properties: code: type: string message: type: string ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array msg: type: string type: type: string input: {} ctx: type: object type: object required: - loc - msg - type NeedsYouPerson: properties: lead_id: type: string format: uuid name: type: string type: object required: - lead_id - name NeedsYouFailedGroup: properties: code: type: string sender_account_id: anyOf: - type: string format: uuid - type: 'null' sender_name: anyOf: - type: string - type: 'null' count: type: integer first_at: anyOf: - type: string format: date-time - type: 'null' reason: type: string sender_back: anyOf: - type: boolean - type: 'null' type: object required: - code - count - reason responses: Unauthorized: description: The key is missing or not valid. content: application/json: schema: $ref: '#/components/schemas/Error' Forbidden: description: >- The key cannot do this, or your plan does not include it. `detail` says which. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: apiKey: type: apiKey in: header name: X-API-Key description: Your workspace's API key. It starts with `b2b_sk_`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.