{
  "service": "docsumo",
  "displayName": "Docsumo",
  "categories": [
    "AI",
    "Productivity",
    "Data"
  ],
  "authTypes": [
    "api_key"
  ],
  "auth": [
    {
      "type": "api_key",
      "label": "API Key",
      "placeholder": "DOCSUMO_API_KEY",
      "description": "Docsumo API key sent with the apikey header. Copy it from Docsumo API settings."
    }
  ],
  "homepageUrl": "https://www.docsumo.com",
  "actions": [
    {
      "id": "docsumo.get_account_info",
      "service": "docsumo",
      "name": "get_account_info",
      "description": "Get Docsumo account details, monthly document quota usage, and the currently enabled document types.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false,
        "description": "No input parameters are required for retrieving account info."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "email": {
            "anyOf": [
              {
                "type": "string",
                "description": "The authenticated Docsumo account email address."
              },
              {
                "type": "null"
              }
            ]
          },
          "fullName": {
            "anyOf": [
              {
                "type": "string",
                "description": "The authenticated Docsumo account full name."
              },
              {
                "type": "null"
              }
            ]
          },
          "userId": {
            "anyOf": [
              {
                "type": "string",
                "description": "The authenticated Docsumo user identifier."
              },
              {
                "type": "null"
              }
            ]
          },
          "monthlyDocCurrent": {
            "anyOf": [
              {
                "type": "integer",
                "description": "The number of documents processed in the current billing cycle."
              },
              {
                "type": "null"
              }
            ]
          },
          "monthlyDocLimit": {
            "anyOf": [
              {
                "type": "integer",
                "description": "The document-processing limit for the current billing cycle."
              },
              {
                "type": "null"
              }
            ]
          },
          "documentTypes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "title": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The display name of the document type."
                },
                "value": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The stable document type identifier used in API requests."
                }
              },
              "additionalProperties": false,
              "description": "One enabled Docsumo document type."
            },
            "description": "The currently enabled document types available to the Docsumo account."
          }
        },
        "additionalProperties": false,
        "description": "Normalized Docsumo account and document-type information."
      }
    },
    {
      "id": "docsumo.get_document_detail",
      "service": "docsumo",
      "name": "get_document_detail",
      "description": "Get Docsumo document detail metadata for one document, including page information and preview assets.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "docId": {
            "type": "string",
            "minLength": 1,
            "description": "The Docsumo document identifier to retrieve."
          }
        },
        "additionalProperties": false,
        "description": "Input parameters for retrieving one Docsumo document detail record."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "document": {
            "type": "object",
            "properties": {
              "data": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "The upstream `document.data` payload returned by Docsumo."
              },
              "docId": {
                "type": "string",
                "minLength": 1,
                "description": "The unique Docsumo document identifier."
              },
              "pages": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "One document page metadata object returned by Docsumo."
                },
                "description": "The page metadata returned by Docsumo for this document."
              },
              "previewImage": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": true,
                    "description": "The preview-image payload returned by Docsumo for this document."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "type": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The document type identifier."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "typeTitle": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The display name of the document type."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "uploadedBy": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": true,
                    "description": "The upstream uploader payload returned by Docsumo for this document."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "userId": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The Docsumo user identifier associated with the document."
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": false,
            "description": "One normalized Docsumo document detail payload."
          }
        },
        "additionalProperties": false,
        "description": "Normalized Docsumo document detail response."
      }
    },
    {
      "id": "docsumo.get_documents_summary",
      "service": "docsumo",
      "name": "get_documents_summary",
      "description": "Get the Docsumo documents summary grouped by document type, including disabled types and status counts.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false,
        "description": "No input parameters are required for documents summary."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "disabledDocTypes": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "One disabled document type identifier."
            },
            "description": "The document type identifiers Docsumo marks as disabled for the account."
          },
          "documentType": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "canUpload": {
                    "anyOf": [
                      {
                        "type": "boolean",
                        "description": "Whether the connected user can upload this document type."
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "category": {
                    "anyOf": [
                      {
                        "type": "string",
                        "description": "The Docsumo category label for this document type."
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "defaultType": {
                    "anyOf": [
                      {
                        "type": "boolean",
                        "description": "Whether Docsumo marks this as a default document type."
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "counts": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "all": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "description": "The total number of documents of this type."
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "processed": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "description": "The number of processed documents of this type."
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "reviewing": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "description": "The number of reviewing documents of this type."
                              },
                              {
                                "type": "null"
                              }
                            ]
                          }
                        },
                        "additionalProperties": false,
                        "description": "The Docsumo counts grouped by processing status."
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "docType": {
                    "anyOf": [
                      {
                        "type": "string",
                        "description": "The stable document type identifier."
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "excelType": {
                    "anyOf": [
                      {
                        "type": "boolean",
                        "description": "Whether Docsumo marks the document type as Excel-based."
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "flags": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {},
                        "additionalProperties": true,
                        "description": "The feature flags Docsumo returns for this document type."
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "id": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "description": "The numeric upstream document-type identifier."
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "isEditable": {
                    "anyOf": [
                      {
                        "type": "boolean",
                        "description": "Whether the document type is editable in Docsumo."
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "models": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "description": "One model identifier."
                    },
                    "description": "The model identifiers associated with this document type."
                  },
                  "title": {
                    "anyOf": [
                      {
                        "type": "string",
                        "description": "The display title of the document type."
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "uploadEmail": {
                    "anyOf": [
                      {
                        "type": "string",
                        "description": "The dedicated Docsumo upload email address for this document type."
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "userId": {
                    "anyOf": [
                      {
                        "type": "string",
                        "description": "The Docsumo user identifier associated with this type."
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "additionalProperties": false,
                "description": "The document-type summary object returned by Docsumo documents summary."
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "additionalProperties": false,
        "description": "Normalized Docsumo documents summary response."
      }
    },
    {
      "id": "docsumo.get_extracted_data",
      "service": "docsumo",
      "name": "get_extracted_data",
      "description": "Get the simplified extracted Docsumo data for one document and preserve the dynamic section and field structure.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "docId": {
            "type": "string",
            "minLength": 1,
            "description": "The Docsumo document identifier to retrieve extracted data for."
          }
        },
        "additionalProperties": false,
        "description": "Input parameters for retrieving simplified Docsumo extracted data."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "extractedData": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The dynamic extracted-data payload returned by Docsumo, grouped by upstream section names."
          }
        },
        "additionalProperties": false,
        "description": "The simplified extracted data returned by Docsumo."
      }
    },
    {
      "id": "docsumo.list_documents",
      "service": "docsumo",
      "name": "list_documents",
      "description": "List Docsumo documents with optional folder, type, status, search, sorting, and created-date filters.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "view": {
            "type": "string",
            "enum": [
              "files",
              "folder",
              "all_files"
            ],
            "description": "How Docsumo should scope the listing: `files`, `folder`, or `all_files`."
          },
          "folderId": {
            "type": "string",
            "minLength": 1,
            "description": "The folder identifier to list documents from when `view` is `folder`."
          },
          "limit": {
            "type": "integer",
            "minimum": 0,
            "maximum": 20,
            "description": "The maximum number of documents to return. Official docs cap this at 20."
          },
          "offset": {
            "type": "integer",
            "minimum": 0,
            "description": "The number of documents to skip before returning results."
          },
          "docType": {
            "type": "string",
            "minLength": 1,
            "description": "The Docsumo document type identifier to filter by."
          },
          "status": {
            "type": "string",
            "enum": [
              "reviewing",
              "processed",
              "erred"
            ],
            "description": "The Docsumo processing status to filter by."
          },
          "query": {
            "type": "string",
            "minLength": 1,
            "description": "A partial-match search query applied to document titles."
          },
          "sortBy": {
            "type": "string",
            "enum": [
              "created_date.asc",
              "created_date.desc"
            ],
            "description": "The sort order for document creation time."
          },
          "createdDateGte": {
            "type": "string",
            "minLength": 10,
            "maxLength": 10,
            "description": "A date string in YYYY-MM-DD format.",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
          },
          "createdDateLte": {
            "type": "string",
            "minLength": 10,
            "maxLength": 10,
            "description": "A date string in YYYY-MM-DD format.",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
          }
        },
        "additionalProperties": false,
        "description": "Input parameters for listing Docsumo documents."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "documents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "approvedWithWarnings": {
                  "anyOf": [
                    {
                      "type": "boolean",
                      "description": "Whether Docsumo approved the document despite validation warnings."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "createdAtIso": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The ISO 8601 timestamp when the document was created."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "displayType": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The Docsumo display bucket such as `files` or `folder`."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "docId": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The unique Docsumo document identifier."
                },
                "docMetaData": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The metadata string stored with the document when returned."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "folderId": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The folder identifier containing the document when present."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "folderName": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The folder name containing the document when present."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "hasFeedback": {
                  "anyOf": [
                    {
                      "type": "boolean",
                      "description": "Whether the document currently has review feedback."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "modifiedAtIso": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The ISO 8601 timestamp when the document was last modified."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "previewImage": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "url": {
                          "type": "string",
                          "minLength": 1,
                          "description": "The preview image URL."
                        },
                        "width": {
                          "type": "integer",
                          "description": "The preview image width in pixels."
                        },
                        "height": {
                          "type": "integer",
                          "description": "The preview image height in pixels."
                        }
                      },
                      "additionalProperties": false,
                      "description": "The preview image metadata returned by Docsumo."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "reviewUrl": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The Docsumo review URL for the document."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "s3Filename": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The upstream storage filename returned by Docsumo when present."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "status": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The current Docsumo processing status."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "templateDocId": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The upstream template document identifier when present."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "time": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "processingTime": {
                          "anyOf": [
                            {
                              "type": "number",
                              "description": "The document processing time in seconds when returned."
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "totalTime": {
                          "anyOf": [
                            {
                              "type": "number",
                              "description": "The total processing time in seconds when returned."
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "additionalProperties": false,
                      "description": "Processing timing metadata returned by Docsumo."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "title": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The document title returned by Docsumo."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "type": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The document type identifier."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "typeTitle": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The display title for the document type."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "uploadedBy": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "avatarUrl": {
                          "anyOf": [
                            {
                              "type": "string",
                              "description": "The uploader avatar URL when returned."
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "email": {
                          "anyOf": [
                            {
                              "type": "string",
                              "description": "The uploader email address when returned."
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "fullName": {
                          "anyOf": [
                            {
                              "type": "string",
                              "description": "The uploader full name when returned."
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "userId": {
                          "anyOf": [
                            {
                              "type": "string",
                              "description": "The uploader user identifier when returned."
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "additionalProperties": false,
                      "description": "The Docsumo uploader metadata."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "userDocId": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The caller-supplied external document identifier when returned."
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "additionalProperties": false,
              "description": "One normalized Docsumo document summary record."
            },
            "description": "The documents returned by Docsumo for this query."
          },
          "pagination": {
            "type": "object",
            "properties": {
              "limit": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "The maximum number of records returned in this response."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "offset": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "The zero-based result offset returned by Docsumo."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "total": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "The total number of records matching the current query."
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": false,
            "description": "The pagination metadata returned by Docsumo."
          }
        },
        "additionalProperties": false,
        "description": "Normalized Docsumo document list response."
      }
    },
    {
      "id": "docsumo.upload_document_from_url",
      "service": "docsumo",
      "name": "upload_document_from_url",
      "description": "Upload one public file URL to Docsumo for a chosen document type and return the queued document metadata.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "docType": {
            "type": "string",
            "minLength": 1,
            "description": "The Docsumo document type identifier to process the file with."
          },
          "fileUrl": {
            "type": "string",
            "description": "The public file URL that Docsumo should download and process.",
            "format": "uri"
          },
          "userDocId": {
            "type": "string",
            "minLength": 1,
            "description": "An optional caller-defined document identifier for external tracking."
          },
          "docMetaData": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "Optional metadata that will be JSON-stringified and attached to the uploaded document."
          },
          "reviewToken": {
            "type": "boolean",
            "description": "Whether Docsumo should return a temporary signed review URL for external review."
          },
          "password": {
            "type": "string",
            "minLength": 1,
            "description": "The password for the source document when it is password-protected."
          }
        },
        "additionalProperties": false,
        "required": [
          "docType",
          "fileUrl"
        ],
        "description": "Input parameters for uploading one public file URL to Docsumo."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "document": {
            "type": "object",
            "properties": {
              "createdAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The upstream document creation timestamp when returned."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "docId": {
                "type": "string",
                "minLength": 1,
                "description": "The unique Docsumo document identifier."
              },
              "docMetaData": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The metadata string stored with the uploaded document when returned."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "email": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The email address associated with the uploaded document."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "reviewUrl": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The Docsumo review URL for the uploaded document."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "status": {
                "type": "string",
                "minLength": 1,
                "description": "The current Docsumo processing status."
              },
              "title": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The document title returned by Docsumo."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "type": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The uploaded document type identifier."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "userDocId": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The caller-supplied external document identifier when returned."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "userId": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The Docsumo user identifier that owns the document."
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": false,
            "description": "Normalized Docsumo uploaded-document metadata."
          }
        },
        "additionalProperties": false,
        "description": "Normalized metadata returned after queueing a Docsumo URL upload."
      }
    }
  ]
}
