# List partnership invitations and requests

`provider_relationships.list_invitations_and_requests`

List partnership invitations and connection requests sent or received by this portal. Each row identifies this workspace's role and the actions currently available. Read this before accepting, rejecting, resending, or withdrawing one, and follow next_cursor until the target is found. Results never expose invitation links or internal database IDs.

[Partnerships guide](https://docs.levr.ai/mcp/resources/provider_relationships.md)

Availability depends on live discovery and your access to the record. Do not infer MCP calls from REST paths.

Operation: read. Required OAuth scopes: mcp.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "cursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "page_size": {
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "provider_slug": {
      "description": "Copy provider_slug from providers.list; named slugs are valid.",
      "maxLength": 255,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "provider_slug"
  ],
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "oneOf": [
    {
      "not": {
        "required": [
          "error"
        ]
      },
      "properties": {
        "ok": {
          "const": true
        }
      },
      "required": [
        "data"
      ]
    },
    {
      "not": {
        "required": [
          "data"
        ]
      },
      "properties": {
        "ok": {
          "const": false
        }
      },
      "required": [
        "error"
      ]
    }
  ],
  "properties": {
    "data": {
      "additionalProperties": false,
      "properties": {
        "items": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "allowed_actions": {
                "items": {
                  "enum": [
                    "accept",
                    "reject",
                    "resend",
                    "withdraw"
                  ],
                  "type": "string"
                },
                "type": "array"
              },
              "created_at": {
                "type": "string"
              },
              "expires_at": {
                "format": "date-time",
                "type": [
                  "string",
                  "null"
                ]
              },
              "invited_company_name": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "invited_email": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "process_id": {
                "description": "Stable public identifier for the referenced resource.",
                "maxLength": 255,
                "minLength": 1,
                "type": "string"
              },
              "process_kind": {
                "enum": [
                  "invitation",
                  "request"
                ],
                "type": "string"
              },
              "receiver_provider_slug": {
                "description": "Stable public identifier for the referenced resource.",
                "maxLength": 255,
                "minLength": 1,
                "type": "string"
              },
              "sender_provider_slug": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "status": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              },
              "workspace_role": {
                "enum": [
                  "sender",
                  "receiver"
                ],
                "type": "string"
              }
            },
            "required": [
              "process_kind",
              "process_id",
              "status",
              "sender_provider_slug",
              "receiver_provider_slug",
              "invited_email",
              "invited_company_name",
              "expires_at",
              "workspace_role",
              "allowed_actions",
              "created_at",
              "updated_at"
            ],
            "type": "object"
          },
          "maxItems": 100,
          "type": "array"
        },
        "next_cursor": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "items",
        "next_cursor"
      ],
      "type": "object"
    },
    "error": {
      "additionalProperties": false,
      "properties": {
        "code": {
          "type": "string"
        },
        "details": {
          "additionalProperties": true,
          "description": "Optional bounded, agent-safe correction or recovery facts.",
          "type": "object"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        }
      },
      "required": [
        "code",
        "message",
        "retryable"
      ],
      "type": "object"
    },
    "meta": {
      "additionalProperties": false,
      "properties": {
        "request_id": {
          "type": "string"
        }
      },
      "required": [
        "request_id"
      ],
      "type": "object"
    },
    "ok": {
      "description": "Whether the tool completed successfully.",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "meta"
  ],
  "type": "object"
}
```
