> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superoffice.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Generate a document

> How to generate a document with REST.

<Tabs>
  <Tab title="RESTful REST API">
    ```javascript theme={null}
    var doc = {}
    doc.Header = "Testing test";
    doc.Name = "foo.doc";
    doc.OurRef = "foo/1";
    doc.YourRef = "bar/99";
    doc.Description = "BAZ FTW";
    doc.DocumentTemplate = { DocumentTemplateId = 2 };
    doc.Contact = { ContactId = 25 };
    doc.Person = { PersonId = 63, ContactId = 25, };
    doc = Post("api/v1/Document", doc);
    ```

    At this point, the document record has been created, but the content is not generated yet. We can either upload some content directly:

    ```javascript theme={null}
    id = res.DocumentId;
    content = "This is some document content.";
    Put("api/v1/Document/" + id + "/content", content)
    ```

    Or we can use the document template to generate a fresh document for us:

    ```javascript theme={null}
    id = res.DocumentId;
    Post("api/v1/Document/" + id + "/content")
    content = Get("api/v1/Document/" + id + "/content")
    ```
  </Tab>

  <Tab title="HTTP RPC Agent API">
    ```javascript theme={null}
    var doc = {}
    doc.Header = "Testing test";
    doc.Name = "foo.doc";
    doc.OurRef = "foo/1";
    doc.YourRef = "bar/99";
    doc.Description = "BAZ FTW";
    doc.DocumentTemplate = { DocumentTemplateId = 2 };
    doc.Contact = { ContactId = 25 };
    doc.Person = { PersonId = 63, ContactId = 25 };
    doc = Post("api/v1/Agents/Document/SaveDocumentEntity", doc);
    ```

    At this point, the document record has been created, but the content is not generated yet. We can either upload some content directly:

    ```javascript theme={null}
    id = doc.DocumentId;
    content = "This is some document content.";
    var req = { DocumentId: id, Stream: content }
    doc = Post("api/v1/Agents/Document/SetDocumentStreamFromId", req);
    ```

    Or we can use the document template to generate a fresh document for us:

    ```javascript theme={null}
    id = doc.DocumentId;
    var req = { DocumentId: id }
    doc = Post("api/v1/Agents/Document/CreateNewPhysicalDocumentFromTemplate", req);
    ```
  </Tab>
</Tabs>

This will generate a new document based on the template and return the updated document object to us.

<Note>
  The examples are given in JavaScripty pseudocode.
</Note>


## Related topics

- [Index](/en/api/reference/restful/agent/index.md)
- [REST WebAPI](/en/api/web-services/endpoints/rest-webapi/index.md)
- [Agents WebAPI](/en/api/web-services/endpoints/agents-webapi/index.md)
- [Generate Quote Documents](/en/api/reference/restful/agent/quote_agent/generate-quote-documents.md)
- [Quote document](/en/automation/crmscript/howto/quote/quote-document.md)
- [SuperOffice.WebApi.Data.Quote GenerateQuoteDocumentsRequest](/en/api/reference/webapi/SuperOffice.WebApi.Data.Quote_GenerateQuoteDocumentsRequest.md)