ITGlue

Create a new document in ITGlue, associated with an organization.

The document is created as a draft. Use itglue_publish_document to publish it. Use itglue_create_document_section to add content sections after creation.

Args:

• organization_id (number, required): Organization to associate the document with
• name (string, required): Document name/title
• response_format ("markdown"|"json", default "markdown"): Output format

Returns: The newly created document with its assigned ID and metadata.

Examples:

• "Create a new runbook for org 123" -> { organization_id: 123, name: "Server Maintenance Runbook" }

Error Handling:

• Returns "Error: Validation failed..." if required fields are missing
• Returns "Error: Resource not found..." if the organization doesn't exist

Add a new section to an existing document.

Section types and their attributes:

• Text: content (HTML body)
• Heading: content (heading text), level (1-6, REQUIRED)
• Gallery: no additional attributes
• Step: content (HTML body), duration (minutes, optional), reset_count (boolean, optional)

Note: rendered_content is READ-ONLY and auto-generated. Do not include it.

Args:

• document_id (number, required): Parent document ID
• section_type ("Text"|"Heading"|"Gallery"|"Step", required): The type of section
• content (string, optional): HTML content for Text/Step sections, or plain heading text for Heading sections
• level (number 1-6, optional): Heading level. REQUIRED for Heading sections.
• duration (number, optional): Duration in minutes. Step sections only.
• reset_count (boolean, optional): Reset step count. Step sections only.
• sort (number, optional): Sort order/position within the document (0-indexed)
• response_format ("markdown"|"json", default "markdown"): Output format

Returns: The newly created section with its assigned ID.

Examples:

• "Add a heading to document 456" -> { document_id: 456, section_type: "Heading", content: "Overview", level: 2 }
• "Add body text" -> { document_id: 456, section_type: "Text", content: "<p>Server details...</p>" }
• "Add a step" -> { document_id: 456, section_type: "Step", content: "<p>Install the app.</p>", duration: 5 }

Error Handling:

• Returns "Error: Validation failed..." if required fields are missing (e.g., level for Heading sections)
• Returns "Error: Resource not found..." if the document doesn't exist

Permanently delete a document section by its ID. This action CANNOT be undone.

The section and all its content will be permanently removed from the parent document.

Args:

• document_id (number, required): The parent document ID
• section_id (number, required): The section ID to delete

Returns: Confirmation of successful deletion.

Examples:

• "Delete section 789 from document 456" -> { document_id: 456, section_id: 789 }

Error Handling:

• Returns "Error: Resource not found..." if the section doesn't exist

Permanently delete one or more documents by their IDs. This action CANNOT be undone.

All sections and content within the deleted documents will also be permanently removed.

Args:

• document_ids (number[], required): Array of document IDs to delete (minimum 1)

Returns: Confirmation of deletion with the list of deleted IDs.

Examples:

• "Delete document 456" -> { document_ids: [456] }
• "Delete documents 100, 200, 300" -> { document_ids: [100, 200, 300] }

Error Handling:

• Returns "Error: Resource not found..." if any document ID doesn't exist

Get a specific document by ID, including all embedded sections with their content.

Returns the full document structure with metadata and all sections (headings, text, steps, galleries). Section content is HTML. For markdown output, HTML is converted to plain text.

If the document has many sections, content may be truncated. Use itglue_get_document_section to retrieve individual sections in full.

Args:

• document_id (number, required): The document ID
• response_format ("markdown"|"json", default "markdown"): Output format

Returns: Document metadata plus all sections with their content, type, and position.

Examples:

• "Show me document 456" -> { document_id: 456 }
• "Get raw data for document 789" -> { document_id: 789, response_format: "json" }

Error Handling:

• Returns "Error: Resource not found..." if the document ID doesn't exist

Get a specific document section by its ID with full content.

Returns the section's type, position, raw HTML content, rendered content (with image URLs), and timestamps. Use this to retrieve the full content of a section that may have been truncated in itglue_get_document.

Args:

• document_id (number, required): The parent document ID
• section_id (number, required): The section ID
• response_format ("markdown"|"json", default "markdown"): Output format

Returns: Full section details including content (HTML), rendered_content, type, position.

Examples:

• "Get section 789 from document 456" -> { document_id: 456, section_id: 789 }
• "Get raw HTML for section 789" -> { document_id: 456, section_id: 789, response_format: "json" }

Error Handling:

• Returns "Error: Resource not found..." if the document or section ID doesn't exist

Get detailed information about a specific ITGlue organization by its ID.

Returns the organization's name, description, type, status, short name, alerts, quick notes, and timestamps.

Args:

• organization_id (number, required): The organization ID
• response_format ("markdown"|"json", default "markdown"): Output format

Returns: Full organization details including all metadata fields.

Examples:

• "Get details for organization 12345" -> { organization_id: 12345 }

Error Handling:

• Returns "Error: Resource not found..." if the organization ID doesn't exist

List all sections belonging to a specific document.

Returns section metadata including type, position, content preview, and timestamps. Sections are returned in position order.

Args:

• document_id (number, required): The parent document ID
• page_number (number, default 1): Page number
• page_size (number, default 50, max 1000): Results per page
• response_format ("markdown"|"json", default "markdown"): Output format

Returns: Paginated list of sections with id, type, position, content, and timestamps.

Examples:

• "Show sections of document 456" -> { document_id: 456 }

Error Handling:

• Returns "Error: Resource not found..." if the document doesn't exist

List and search documents within a specific organization, including documents inside folders.

Returns document metadata including name, organization, published status, and timestamps. Does NOT return document content — use itglue_get_document for full content. Use itglue_list_organizations first if you need to find the organization ID.

Internally makes two API calls to retrieve both root-level and folder-nested documents, then merges the results. Pagination params apply to each call separately, so up to 2x page_size results may be returned.

Args:

• organization_id (number, required): Organization ID to list documents for
• filter_name (string, optional): Filter by document name (partial match)
• filter_id (number, optional): Filter by specific document ID
• sort (string, optional): Sort field (e.g. "name", "-updated_at")
• page_number (number, default 1): Page number
• page_size (number, default 50, max 1000): Results per page
• response_format ("markdown"|"json", default "markdown"): Output format

Returns: Paginated list of documents with id, name, organization, published status, and timestamps.

Examples:

• "Find network docs in org 123" -> { organization_id: 123, filter_name: "network" }
• "List all documents for org 123" -> { organization_id: 123 }
• "Show recent documents" -> { organization_id: 123, sort: "-updated_at" }

Error Handling:

• Returns "Error: Authentication failed..." if API key is invalid
• Returns "Error: Rate limit exceeded..." if too many requests

Search and list organizations in ITGlue. Use this to find organization IDs needed for document operations.

Supports filtering by name, ID, type, and status. Results are paginated.

Args:

• filter_name (string, optional): Filter by organization name (partial match)
• filter_id (number, optional): Filter by specific organization ID
• filter_organization_type_id (number, optional): Filter by organization type
• filter_organization_status_id (number, optional): Filter by status
• sort (string, optional): Sort field (e.g. "name", "-updated_at")
• page_number (number, default 1): Page number
• page_size (number, default 50, max 1000): Results per page
• response_format ("markdown"|"json", default "markdown"): Output format

Returns: List of organizations with id, name, description, type, status, and timestamps.

Examples:

• "Find the Acme Corp organization" -> { filter_name: "Acme" }
• "List all organizations sorted by name" -> { sort: "name" }

Error Handling:

• Returns "Error: Authentication failed..." if API key is invalid
• Returns "Error: Rate limit exceeded..." if too many requests

Publish a draft document, making it visible to all users with appropriate access.

Args:

• document_id (number, required): The document ID to publish
• response_format ("markdown"|"json", default "markdown"): Output format

Returns: Confirmation of successful publication.

Examples:

• "Publish document 456" -> { document_id: 456 }

Error Handling:

• Returns "Error: Resource not found..." if the document doesn't exist

Update an existing document's metadata (name).

Does NOT modify document section content — use itglue_update_document_section for content changes.

Args:

• document_id (number, required): The document ID to update
• name (string, optional): New document name
• response_format ("markdown"|"json", default "markdown"): Output format

Returns: The updated document with current metadata.

Examples:

• "Rename document 456 to 'Updated Runbook'" -> { document_id: 456, name: "Updated Runbook" }

Error Handling:

• Returns "Error: Resource not found..." if the document doesn't exist
• Returns "Error: Validation failed..." if the document is externally synced

Update an existing document section's content or sort order.

Content should be provided as HTML. Only specified fields are updated; omitted fields remain unchanged. The section type (resource_type) cannot be changed after creation. rendered_content is READ-ONLY and auto-generated — do not include it.

Args:

• document_id (number, required): The parent document ID
• section_id (number, required): The section ID to update
• content (string, optional): New HTML content (or heading text for Heading sections)
• level (number 1-6, optional): New heading level (Heading sections only)
• duration (number, optional): Duration in minutes (Step sections only)
• reset_count (boolean, optional): Reset step count (Step sections only)
• sort (number, optional): New sort order/position within the document
• response_format ("markdown"|"json", default "markdown"): Output format

Returns: The updated section with current content and metadata.

Examples:

• "Update content of section 789 in document 456" -> { document_id: 456, section_id: 789, content: "<p>New content</p>" }
• "Move section to position 0" -> { document_id: 456, section_id: 789, sort: 0 }

Error Handling:

• Returns "Error: Resource not found..." if the section doesn't exist