{"_id":"59c4267167a94900103a2574","category":"59c4267167a94900103a2561","parentDoc":null,"project":"55d2023b3c74062300aee506","user":"55d201fe945e481700afbb19","version":"59c4267167a94900103a2560","updates":["5835c945524e752500ba93bc"],"next":{"pages":[],"description":""},"createdAt":"2015-09-27T18:57:20.311Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"The PlanGrid API is hosted at [io.plangrid.com](https://io.plangrid.com).\n\nThis documentation describes PlanGrid’s API standards, data model, and endpoints. We strive for documentation that is understandable, detailed, and comprehensive. Please suggest edits when you feel we’re not accomplishing these goals (or forget commas).\n\nEvery endpoint in the PlanGrid API has a dedicated section and can be tested using the API Explorer (accessed via a button at the end of the section). The API Explorer may require you to enter your API key.","excerpt":"Our promise.","slug":"introduction","type":"basic","title":"Introduction","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a2575","category":"59c4267167a94900103a2561","parentDoc":null,"project":"55d2023b3c74062300aee506","user":"55d201fe945e481700afbb19","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-10-20T20:41:42.171Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"code":"{}","name":"","status":200,"language":"json"},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":1,"body":"Our team is happy to answer any questions, address any frustrations, or consider any requests. You can communicate with us in the following ways:\n\n- [Request an invite](mailto:developers@plangrid.com?subject=PlanGrid API Slack channel invite request) to our Slack channel to chat with us and other PlanGrid API experts.\n- Post a question in [Stack Overflow](http://stackoverflow.com/questions/tagged/plangrid-api) and tag it with [`plangrid-api`](http://stackoverflow.com/questions/tagged/plangrid-api).\n- Contact support directly by emailing [developers@plangrid.com](mailto:developers@plangrid.com).\n\nWe'll do our best to accommodate you.","excerpt":"Did you try turning it off and on again?","slug":"support","type":"basic","title":"Support","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a2576","category":"59c4267167a94900103a2561","parentDoc":null,"project":"55d2023b3c74062300aee506","user":"55d201fe945e481700afbb19","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-10-20T20:55:50.291Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[{"code":"{}","name":"","status":200,"language":"json"},{"status":400,"language":"json","code":"{}","name":""}]},"auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"We use conventions in our documentation to help you navigate and understand it.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Nomenclature\"\n}\n[/block]\nWe use consistent naming to describe concepts and features of an API:\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"*Record*\",\n    \"0-1\": \"A single, implicitly structured data item. 99% of the time they have a unique identifier.\",\n    \"0-2\": \"Each project in PlanGrid is considered a record\",\n    \"1-0\": \"*Attribute* \",\n    \"1-1\": \"A named value inside a record.\",\n    \"1-2\": \"`project.name`\",\n    \"2-0\": \"*Object* \",\n    \"2-1\": \"Represents and defines a common record.\",\n    \"2-2\": \"[The Project object](doc:the-project-object)\",\n    \"4-0\": \"*Endpoint* \",\n    \"4-1\": \"An API method\",\n    \"5-0\": \"*Parameter* \",\n    \"5-1\": \"A variable value passed to an endpoint\",\n    \"4-2\": \"GET `/projects`\",\n    \"5-2\": \"POST `/projects` needs a `name` parameter\",\n    \"6-0\": \"*Request* \",\n    \"6-1\": \"Calling an endpoint via an HTTP request\",\n    \"6-2\": \"-\",\n    \"h-0\": \"Word\",\n    \"h-1\": \"Meaning\",\n    \"h-2\": \"Example\",\n    \"3-2\": \"[The RFI object](doc:the-rfi-object) contains an attribute that is a reference to its comments `rfi.comments`\",\n    \"3-1\": \"A pointer or foreign key to a record\",\n    \"3-0\": \"*Reference*\",\n    \"7-0\": \"*Response*\",\n    \"7-1\": \"The result of an HTTP request to an endpoint\",\n    \"7-2\": \"-\"\n  },\n  \"cols\": 3,\n  \"rows\": 8\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Organization\"\n}\n[/block]\nOur documentation is structured into categories in the following order:\n\n- *Introduction* - Introduces you to the API, our documentation, and how to start using it.\n- *Standards* - Describes our API standards and conventions.\n- *Common Objects* - Describes common objects used across multiple endpoints. Pages are ordered alphabetically.\n- *[Resource]* - Resource accessed via a URL pattern of `/[resource]` or `/projects/:project_uid/[resource]`. Ordered alphabetically.\n\n### Resources\n\nTo make the table of contents easily skimmable, documentation pages in Resource categories order by [CRUD](https://en.wikipedia.org/wiki/Create,_read,_update_and_delete):\n\n- Object definitions and background information on the resource\n- Endpoints and associated documentation to create a record\n- Endpoints and associated documentation to list records\n- Endpoints and associated documentation to retrieve single records\n- Endpoints and associated documentation to update a record\n- Endpoints and associated documentation to remove a record\n- Miscellanious endpoints and associated documentation related to the resource","excerpt":"","slug":"documentation-conventions","type":"basic","title":"Conventions","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a2577","category":"59c4267167a94900103a2561","project":"55d2023b3c74062300aee506","parentDoc":null,"user":"55d201fe945e481700afbb19","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-08-04T17:56:01.191Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"language":"json","code":"{}","name":"","status":200},{"name":"","status":400,"language":"json","code":"{}"}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"To make it even easier to get started with the PlanGrid API, we provide libraries for the following languages and frameworks:\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Language/Framework\",\n    \"h-1\": \"Source/Download\",\n    \"0-1\": \"[plangrid-api-net](https://github.com/plangrid/plangrid-api-net)\",\n    \"0-0\": \".NET\"\n  },\n  \"cols\": 2,\n  \"rows\": 1\n}\n[/block]\nIf you've built a library for the PlanGrid API and would like it listed, please [contact support](mailto:developers@plangrid.com).","excerpt":"Oh my!","slug":"libraries-and-sdks","type":"basic","title":"Libraries, SDKs, and Packages","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a2578","category":"59c4267167a94900103a2561","parentDoc":null,"project":"55d2023b3c74062300aee506","user":"55d201fe945e481700afbb19","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-07-26T21:58:12.172Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[{"code":"{}","name":"","status":200,"language":"json"},{"language":"json","code":"{}","name":"","status":400}]},"auth":"required","params":[],"url":""},"isReference":false,"order":4,"body":"We provide API access to PlanGrid customers and partners. If you're a customer, [please contact sales](https://www.plangrid.com/contact/) to purchase API access. If you're a software vendor interested in partnering, [please contact our partnerships team](mailto:partners@plangrid.com).","excerpt":"Tickets?","slug":"access","type":"basic","title":"Access","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a2579","category":"59c4267167a94900103a2561","user":"55d201fe945e481700afbb19","parentDoc":null,"project":"55d2023b3c74062300aee506","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-09-04T23:55:39.000Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":5,"body":"We don’t expect you to read our documentation like a book (you’ll get a little bored). Instead, we’d like to get you started right away and help you find the documentation you need. If that sounds appealing, keep reading. Otherwise, jump to [Standards](doc:getting-started).\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Get a List of Your Projects\"\n}\n[/block]\nWith 5 seconds of effort, you’ll grab a list of PlanGrid projects. We'll send HTTP requests to the PlanGrid API via the `curl` command. On Windows, you’ll need to install `curl` by downloading and running the “#.#.# - SSL enabled SSH enabled” installer [here](http://curl.haxx.se/dlwiz/?type=bin&os=Win32&flav=-&ver=*).\n\nOpen up a Terminal (OS X) or Command Prompt (Windows) and run the following command:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -i https://io.plangrid.com/projects -u [[app:key]]: -H \\\"Accept: application/vnd.plangrid+json; version=1\\\"\",\n      \"language\": \"curl\"\n    }\n  ]\n}\n[/block]\nBelow your command a list of projects should have been returned.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"data\\\": [\\n    {\\n      \\\"uid\\\": \\\"bafce976-8f33-437f-9c52-fb274456940f\\\",\\n      \\\"name\\\": \\\"LA Natural History Museum\\\"\\n    },\\n    {\\n      \\\"uid\\\": \\\"327e8c64-a70d-433c-b4ac-d077415a5547\\\",\\n      \\\"name\\\": \\\"3265 17th Street\\\"\\n    }\\n  ],\\n  \\\"total_count\\\": 2,\\n  \\\"next_page_url\\\": null\\n}\",\n      \"language\": \"json\"\n    }\n  ],\n  \"sidebar\": true\n}\n[/block]\nCongratulations, you’ve successfully used the PlanGrid API! You may have noticed that you only received fifty projects; the reason is we paginate our results. You can learn more in [Pagination](doc:pagination).","excerpt":"Get your first data out of PlanGrid faster than a Camaro can do 0-60.","slug":"getting-started-1","type":"basic","title":"Quick Start","__v":0,"childrenPages":[]}

{"_id":"59c4267267a94900103a25aa","category":"59c4267167a94900103a2562","parentDoc":null,"project":"55d2023b3c74062300aee506","user":"55d201fe945e481700afbb19","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-08-17T15:48:13.217Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":6,"body":"The PlanGrid API is a [REST](http://en.wikipedia.org/wiki/Representational_State_Transfer) API that uses predictable, resource-oriented URLs and standard [HTTP response codes](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes). It uses built-in HTTP features, such as HTTP authentication and HTTP verbs, so it can be understood by off-the-shelf HTTP clients.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Security\"\n}\n[/block]\nPlanGrid [values](https://help.plangrid.com/customer/portal/articles/1253410-how-secure-is-plangrid-) the security of your data, and all API requests must be made over [HTTPS](https://en.wikipedia.org/wiki/HTTPS). \n\nWe strongly recommend you keep your API key as secure as possible:\n\n- Don't store it in publicly accessible code (e.g. Javascript for a public website).\n- Avoid checking it into source control. Use configuration files that can be loaded into your code.\n\nIf you think your API key is compromised, don't hesitate to [contact support](mailto:developers@plangrid.com). We will deactivate your API key and issue a new one.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"HTTP Verbs\"\n}\n[/block]\nPlanGrid’s API follows IETF standards ([RFC 5789](http://tools.ietf.org/html/rfc5789) & [RFC 7231](https://tools.ietf.org/html/rfc7231#section-4.3)) when using HTTP methods. A summary is provided below:\n\n| Verb | Used for... |\n|------|-------------|\n| GET | Retrieving records |\n| POST | Creating records |\n| PUT | Replacing records |\n| PATCH | Updating records |\n| DELETE | Deleting records |\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Responses\"\n}\n[/block]\nAll responses return [JSON](http://www.json.org/), including errors.\n\n### Blank Attributes\n\nBlank attributes are included as null instead of being omitted. The example below illustrates how the API would return an issue where `assignee`, `room`, and `current_annotation` are blank:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"uid\\\": \\\"22f3530a-a00b-42f9-8139-3a7554c77c27\\\",\\n  \\\"number\\\": 1,\\n  \\\"current_annotation\\\": null,\\n  \\\"title\\\": \\\"Electrical\\\",\\n  \\\"description\\\": \\\"Missing wall outlets.\\\",\\n  \\\"assigned_to\\\": null,\\n  \\\"status\\\": \\\"open\\\",\\n  \\\"created_at\\\": \\\"2015-06-08T18:04:02+00:00\\\",\\n  \\\"created_by\\\": {\\n    \\\"email\\\": \\\"alfred@architect.com\\\"\\n  },\\n  \\\"updated_at\\\": \\\"2013-05-23T19:22:56+00:00\\\",\\n  \\\"room\\\": null,\\n  \\\"updated_by\\\": {\\n    \\\"email\\\": \\\"betty@construction.com\\\"\\n  }\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n### Errors\n\nErrors return a JSON object with a human readable message:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"message\\\": \\\"Project (bafce976-8f33-437f-9c58-fb274456940f) does not exist.\\\"\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nThe value of `message` may be updated in minor and patch versions; don’t write conditions that depend on it.\n\n### HTTP Compression\n\nThe API supports compression and clients can utilize this by requesting an encoding in the `Accept-Encoding` header:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"Accepted-Encoding: gzip, deflate\",\n      \"language\": \"http\",\n      \"name\": \"\"\n    }\n  ]\n}\n[/block]\n\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Requests\"\n}\n[/block]\nMany API methods take optional parameters. For GET requests, any parameters not specified as a segment in the path (prefixed by `:` in our documentation) can be passed as an HTTP query string parameter (prefixed by `?` in our documentation).\n\nIn the example below, the `:project_uid` parameter is passed in as a segment of the URL path while pagination parameters (`?page` and `?per_page`) are passed in as HTTP query string parameters:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl https://io.plangrid.com/projects/bafce976-8f33-437f-9c58-fb274456940f/issues?page=2&per_page=10 -u [[app:key]]: -H \\\"Accept: application/vnd.plangrid+json; version=1\\\"\",\n      \"language\": \"curl\"\n    }\n  ]\n}\n[/block]\nFor POST and PUT requests, parameters not included in the URL are passed in the request body. All request bodies must be encoded as JSON with a Content-Type of `‘application/json’`.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Unique Identifiers\"\n}\n[/block]\nEvery record\\* stored in PlanGrid is assigned a *universally* unique identifier (`uid`) that will not change. UIDs are strings with four dashes between thirty-two alphanumeric characters: `“cce19790-2f7b-46fc-ade0-c932181c35d9”`. You can safely use the PlanGrid `uid` when mapping PlanGrid records with another system’s records.\n\n<sub>* The two exceptions are the [RFI status record](doc:the-rfi-status-object) and [permission role record](doc:the-role-object). For RFI status records, the unique identifiers are strings with 8 alphanumeric characters (`'4898bfd4'`). The unique identifiers for permission role records are strings with four dashes between thirty-two alphanumeric characters (`'17dce2c5-4931-47e7-8c98-84b35f00ba03'`) but are _not_ universally unique.</sub>","excerpt":"Some basic conventions we've established.","slug":"getting-started","type":"basic","title":"Basics","__v":0,"childrenPages":[]}

{"_id":"59c4267267a94900103a25ab","category":"59c4267167a94900103a2562","project":"55d2023b3c74062300aee506","user":"55d201fe945e481700afbb19","parentDoc":null,"version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-09-02T23:46:36.592Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"name":"","status":200,"language":"json","code":"{}"},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":7,"body":"We provide you two methods to authenticate with our API: [OAuth 2.0](https://oauth.net/2/) and [HTTP Basic Auth](https://en.wikipedia.org/wiki/Basic_access_authentication). Depending on the use case and requirements, either method can be used to request PlanGrid data. For most applications we recommend using OAuth 2.0.\n[block:api-header]\n{\n  \"title\": \"OAuth\"\n}\n[/block]\nOur API provides OAuth 2.0 as a protocol for authenticating and authorizing PlanGrid users. When using OAuth, a PlanGrid user will be required to log into their PlanGrid account and authorize your application access to their PlanGrid data. \n\nIf you are a developer looking to get started with OAuth, please [contact us](mailto:developers@plangrid.com) to register your application and obtain your credentials. Once you have received your credentials, you can jump to [Getting Started with OAuth](doc:getting-started-with-oauth).\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Registering your application\",\n  \"body\": \"The following will be required when providing information about your application: application name, logo, and a list of redirect URIs.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"HTTP Basic Auth\"\n}\n[/block]\nTo use HTTP Basic Auth, you must send your API key with every request to the PlanGrid API. Put your API key as the basic auth username and leave the password blank:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl https://io.plangrid.com/projects -u [[app:key]]: -H \\\"Accept: application/vnd.plangrid+json; version=1\\\"\",\n      \"language\": \"curl\"\n    }\n  ]\n}\n[/block]\nIf your API key is missing, the API will respond with a 401 status code. When the provided key is wrong or deactivated, the API will respond with a 403 status code. All three situations return a human-readable response specific to the situation.","excerpt":"Don’t trust strangers.","slug":"authentication","type":"basic","title":"Authentication","__v":0,"childrenPages":[]}

{"_id":"59c4267267a94900103a25ac","category":"59c4267167a94900103a2562","user":"55d201fe945e481700afbb19","project":"55d2023b3c74062300aee506","parentDoc":null,"version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-09-10T23:44:47.701Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"language":"json","code":"{}","name":"","status":400}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":8,"body":"PlanGrid API versioning follows [semantic versioning](http://semver.org/). Any PlanGrid API version will be of the form `MAJOR.MINOR.PATCH`. Given a version number `MAJOR.MINOR.PATCH`, we increment the:\n\n- `MAJOR` version when we make incompatible API changes,\n- `MINOR` version when we add functionality in a backwards-compatible manner, and\n- `PATCH` version when we make backwards-compatible bug fixes.\n\nYou can use any `MINOR` and `PATCH` versions without fear of breaking changes.\n\nYou must explicitely specify the `MAJOR` version of the PlanGrid API via the `Accept` header:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"Accept: application/vnd.plangrid+json; version=[:MAJOR]\",\n      \"language\": \"text\"\n    }\n  ]\n}\n[/block]\nFor instance, with `curl`:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl https://io.plangrid.com/... -H \\\"Accept: application/vnd.plangrid+json; version=1\\\"\",\n      \"language\": \"curl\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Version Support\"\n}\n[/block]\n`MAJOR` versions will be deprecated over time and you will have a 6 month grace period to migrate to a new `MAJOR` version. You will receive a notification via the account email when a `MAJOR` version is deprecated and each subsequent month you continue to use it. After the grace period, you will no longer have access to the deprecated version. \n\nWe will consider longer migration times for future `MAJOR` versions. Please [contact support](mailto:developers@plangrid.com) immediately if you cannot migrate to a newer `MAJOR` version in 6 months.","excerpt":"How we version the API.","slug":"api-versioning","type":"basic","title":"API Versioning","__v":0,"childrenPages":[]}

{"_id":"59c4267267a94900103a25ad","category":"59c4267167a94900103a2562","user":"55d201fe945e481700afbb19","project":"55d2023b3c74062300aee506","parentDoc":null,"version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-03-20T21:53:30.633Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":9,"body":"When deleting records through the PlanGrid app or API, they are removed from the app interface but not from our database. This allows references to deleted records to persist (e.g. a deleted photo still shows up on an RFI that references it) and data recovery to be possible (e.g. a project team member accidentally deletes some sheets).\n\nBy default, deleted records are returned through the API and can be identified when their `deleted` attribute is `true`.","excerpt":"\"Dawn of the Deleted\"","slug":"deleting-records","type":"basic","title":"Deleted Records","__v":0,"childrenPages":[]}

{"_id":"59c4267267a94900103a25ae","category":"59c4267167a94900103a2562","user":"55d201fe945e481700afbb19","project":"55d2023b3c74062300aee506","parentDoc":null,"version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-12-21T01:31:58.176Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":10,"body":"When adding records such as photos or attachments, you'll need to upload the record's file to PlanGrid. This is a two to three step process with the PlanGrid API:\n\n1. First, POST the record's attribute data and content type of its file to the PlanGrid API. PlanGrid creates a temporary record and sends back a [File Upload object](doc:the-file-upload-object) that contains information to upload the file and finalize the record (step two and three, respectively).\n2. Use the `aws_post_form_arguments` attribute in the [File Upload object](doc:the-file-upload-object) to securely POST the record's file to a private location in Amazon S3.\n - `aws_post_form_arguments.action` is the POST URL\n - `aws_post_form_arguments.fields` are the key-value pairs for the POST form fields.\n3. Once the upload is complete, tell the PlanGrid API it's complete via a GET to `webhook_url` provided in the [File Upload object](doc:the-file-upload-object) from step one. This makes the temporary record created in step one permanent. \n\nIf you configure your HTTP client to follow redirects (e.g. with `curl` use the `-L` flag), step three will be handled for you by Amazon S3. \n\nHere is an example in python that uploads a submittal PDF as an attachment to the first project listed via the API:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"import requests\\nfrom collections import OrderedDict\\n\\napi_prefix = 'https://io.plangrid.com'\\napi_key = '[[app:key]]'\\nversion_headers = {'Accept': 'application/vnd.plangrid+json; version=1'}\\n\\ndef get_first_project_uid():\\n    # Get the UID of the first project returned from the API\\n    projects_url = '{}/projects'.format(api_prefix)\\n    response = requests.get(projects_url, auth=(api_key, None), headers=version_headers)\\n    projects = response.json()['data']\\n    first_project_uid = projects[0]['uid']\\n    return first_project_uid\\n\\ndef request_attachment_upload(project_uid):\\n    attachment_upload_url = '{}/projects/{}/attachments/uploads'.format(api_prefix, project_uid)\\n    headers = {'content-type': 'application/json'}\\n    headers.update(version_headers)\\n    data = {'content_type': 'application/pdf', 'name': '0001-060000-1.pdf', 'folder': 'Submittals'}\\n    response = requests.post(attachment_upload_url, json=data, headers=headers,\\n                             auth=(api_key, None))\\n    file_upload_info = response.json()\\n    return file_upload_info\\n\\ndef upload_file(file_upload_info):\\n    url = file_upload_info['aws_post_form_arguments']['action']\\n    fields = file_upload_info['aws_post_form_arguments']['fields']\\n    fields = OrderedDict([(kv['name'], kv['value']) for kv in fields])\\n    files = OrderedDict([('file', open('Submittal_0001-060000-1.pdf'))])\\n    response = requests.post(url, files=files, data=fields)\\n    return response.text\\n\\n# Example\\nproject_uid = get_first_project_uid()\\n\\n# Step 1\\nfile_upload_info = request_attachment_upload(project_uid=project_uid)\\n\\n# Step 2 (3 is handled automatically)\\nprint upload_file(file_upload_info=file_upload_info)\",\n      \"language\": \"python\"\n    }\n  ]\n}\n[/block]\nWhen run, the script prints the new attachment record:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"deleted\\\": false,\\n  \\\"created_at\\\": \\\"2015-12-22T06:11:56.849904+00:00\\\",\\n  \\\"name\\\": \\\"0001-060000-1.pdf\\\",\\n  \\\"uid\\\": \\\"ba65bfcf-a1fe-4dd4-9ef6-b381ac877174\\\",\\n  \\\"url\\\": \\\"https://attachments.s3.amazonaws.com/da48fcc3-7af1-4fd6-a083-70195468718a/ba65bfcf-a1fe-4dd4-9ef6-b381ac877174_0001-060000-1.pdf?Signature=xc10DykUH8z4rcYMo8x%2F4PiH294%3D&Expires=1450782716&AWSAccessKeyId=AKIAIWKPH7OCNIEE5GGQ&response-content-disposition=attachment%3B%20filename%3D%220001-060000-1.pdf%22\\\",\\n  \\\"created_by\\\": {\\n    \\\"email\\\": \\\"abhik@plangrid.com\\\",\\n    \\\"url\\\": \\\"https://io.plangrid.com/projects/da48fcc3-7af1-4fd6-a083-70195468718a/users/54ab24c10d1c74ff22ae4874\\\",\\n    \\\"uid\\\": \\\"54ab24c10d1c74ff22ae4874\\\"\\n  },\\n  \\\"folder\\\": \\\"Submittals\\\"\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]","excerpt":"Give us your PDFs, your GIFs, your JPEGs yearning to be rendered.","slug":"file-uploads","type":"basic","title":"File Uploads","__v":0,"childrenPages":[]}

{"_id":"59c4267267a94900103a25af","category":"59c4267167a94900103a2562","parentDoc":null,"user":"55d201fe945e481700afbb19","project":"55d2023b3c74062300aee506","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-10-23T22:33:46.706Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"language":"json","status":200,"name":"","code":"{}"},{"name":"","code":"{}","language":"json","status":400}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":11,"body":"A record in PlanGrid may reference other records or collections of records. For instance, an issue in PlanGrid references the user who created the issue and a collection of photos. When you retrieve records from the PlanGrid API, it provides a URL to retrieve the references or the denormalized data (typically when the referenced data is small).\n\nAn example where the PlanGrid API denormalizes a reference is with RFIs. Instead of requiring you to retrieve the RFI status record, the API provides the RFI status within the RFI JSON object:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"status\\\": {\\n    uid: '4898bfd4',\\n    label: 'closed',\\n    color: '#000000'\\n  }\\n  ...\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Reference to a Single Record\"\n}\n[/block]\nWhen a PlanGrid record references a single record, the PlanGrid API returns the `uid` of the referenced record and a URL to retrieve the referenced record's data:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"rfi\\\": {\\n    \\\"uid\\\": \\\"437f7130-8ab3-4905-814a-f61fc8bd305c\\\",\\n    \\\"url\\\": \\\"https://io.plangrid.com/projects/78128c72-5862-458a-9577-33eaa189a5c1/rfis/437f7130-8ab3-4905-814a-f61fc8bd305c\\\"\\n  }\\n  ...\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"**uid**\\n`string`\",\n    \"1-0\": \"**url**\\n`string`\",\n    \"0-1\": \"Never blank.\",\n    \"1-1\": \"The URL to retrieve the record's data. Never blank.\",\n    \"h-0\": \"Attribute\",\n    \"h-1\": \"Description\"\n  },\n  \"cols\": 2,\n  \"rows\": 2\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Reference to a Collection of Records\"\n}\n[/block]\nWhen a PlanGrid record references a collection of records, the PlanGrid API returns the number of records in the collection and a URL to retrieve the referenced records:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  photos: {\\n    total_count: 3,\\n    url: \\\"https://io.plangrid.com/projects/78128c72-5862-458a-9577-33eaa189a5c1/issues/8510cfc9-2a82-4736-bf37-753c900d1c68/photos\\\"\\n  }\\n  ...\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Attribute\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"**total_count**\\n`integer`\",\n    \"0-1\": \"Number of records in the collection. Never blank and greater than or equal to zero.\",\n    \"1-0\": \"**url**\\n`string`\",\n    \"1-1\": \"The URL to retrieve the collection of records. Blank if total_count is zero.\"\n  },\n  \"cols\": 2,\n  \"rows\": 2\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Reference to User(s)\"\n}\n[/block]\nReferences to users are a special case. On certain objects ([issues](doc:the-issue-object), [photos](doc:the-photo-object), [attachments](doc:the-attachment-object)), users are referenced by email in PlanGrid's database. The email may not map to a real PlanGrid account, and the PlanGrid API will return a reference with `uid` and `url` set to `null`.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"created_by\\\": {\\n    \\\"uid\\\": null,\\n    \\\"url\\\": null,\\n    \\\"email\\\": \\\"richard@subcontractor.com\\\"\\n  }\\n  ...\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"**uid**\\n`string`\",\n    \"0-1\": \"May be blank.\",\n    \"1-0\": \"**url**\\n`string`\",\n    \"1-1\": \"The URL to retrieve the user record's data. May be blank.\",\n    \"2-0\": \"**email**\\n`string`\",\n    \"2-1\": \"User’s account email. May not be a valid email. Never blank.\",\n    \"h-0\": \"Attribute\",\n    \"h-1\": \"Description\"\n  },\n  \"cols\": 2,\n  \"rows\": 3\n}\n[/block]\nWhen a collection of users is referenced, an array of user references is returned:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"assigned_to\\\": [\\n    {\\n      \\\"uid\\\": null,\\n      \\\"url\\\": null,\\n      \\\"email\\\": \\\"richard@subcontractor.com\\\"\\n    },\\n    {\\n      \\\"uid\\\": \\\"8510cfc9-2a82-4736-bf37-753c900d1c68\\\",\\n      \\\"url\\\": \\\"https://io.plangrid.com/projects/78128c72-5862-458a-9577-33eaa189a5c1/users/8510cfc9-2a82-4736-bf37-753c900d1c68\\\",\\n      \\\"email\\\": \\\"bob@subcontractor.com\\\"\\n    }\\n  ]\\n  ...\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]","excerpt":"Easier than getting a work visa.","slug":"foreign-keys","type":"basic","title":"Foreign Keys","__v":0,"childrenPages":[]}

{"_id":"59c4267267a94900103a25b0","category":"59c4267167a94900103a2562","user":"55d201fe945e481700afbb19","parentDoc":null,"project":"55d2023b3c74062300aee506","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-09-03T00:28:30.618Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":12,"body":"Endpoints that return multiple records use offset based pagination which uses`?limit` and `?skip` query parameters. `?limit` indicates the maximum number of records to return, and `?skip` indicates the number of items to skip in the set of unpaginated records. If an endpoint returned 6 issues, setting `?skip` to 2 and `?limit` to 3 would retrieve the third, fourth, and fifth issue:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/X9uZVY8SSiSXe9g90tV8_image.png\",\n        \"image.png\",\n        \"975\",\n        \"451\",\n        \"#bbbbbb\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nThe default and maximum number for `?limit` is 50, but you can request less. The default `?skip` value starts from the beginning of unpaginated records and is 0.\n\nThe curl command below skips two records and returns a maximum of ten records:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl https://io.plangrid.com/projects?skip=2&limit=10 -u [[app:key]]: -H \\\"Accept: application/vnd.plangrid+json; version=1\\\"\",\n      \"language\": \"curl\"\n    }\n  ]\n}\n[/block]\nThe response to a request that returns multiple records is paginated and is always of the form:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"data\\\": [{}, {}, {}, {}, {}, {}, {}, {}, {}, {}],\\n  \\\"total_count\\\": 14,\\n  \\\"next_page_url\\\": \\\"https://io.plangrid.com/...?skip=12&limit=10\\\",\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n`data` is the array of records matched with `?skip` and `?limit`, `total_count` is the number of unpaginated records, and `next_page_url` is a url to the next page of records -- it will be `null` if you’ve reached the last page.\n\nIf `?limit` or `?skip` are not positive integers or 0, the PlanGrid API will return a 400 with an appropriate message.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Retrieving Records Created/Updated After a Specified Time\"\n}\n[/block]\nIf you're syncing PlanGrid with another system, you probably want to only retrieve records that have changed since your last sync. With the PlanGrid API you can achieve this with the `?updated_after` parameter. When added, the PlanGrid API only retrieves records created or updated after the specified UTC date and time (see [Timestamps and Timezones](doc:timestamps) for accepted date formats). It's supported on endpoints that have the potential to return large numbers of records (e.g. RFIs, issues, comments). For each endpoint you want to use the `?updated_after` parameter, check the endpoint's documentation to determine whether the parameter is supported.\n\nIt's important to note that the updated time of records with references (e.g. RFIs, issues) are updated when references change, but not when comments are added.","excerpt":"Bookmarks sold separately.","slug":"pagination","type":"basic","title":"Pagination","__v":0,"childrenPages":[]}

{"_id":"59c4267267a94900103a25b1","category":"59c4267167a94900103a2562","parentDoc":null,"project":"55d2023b3c74062300aee506","user":"55d201fe945e481700afbb19","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-09-03T00:21:02.109Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"auth":"required","params":[],"url":""},"isReference":false,"order":13,"body":"PlanGrid API keys are attached to PlanGrid accounts. The API key has the same access privileges as the associated PlanGrid account: it can access all projects where the PlanGrid account is a team member and can perform actions allowed by the account’s project permissions. Access privileges for a PlanGrid account are described in detail in our [Help Center](https://help.plangrid.com/customer/portal/articles/1268049#understanding-permission-levels).\n\nTo use a PlanGrid API Key with all of your organization’s projects, add the PlanGrid account with the API key as a team member to each project. We strongly recommend establishing a policy that requires adding this PlanGrid account to every new project.\n\nIf you attempt an action outside your access privileges, the PlanGrid API will return a 403 with an appropriate message.","excerpt":"No access for you!","slug":"permissions","type":"basic","title":"Permissions","__v":0,"childrenPages":[]}

{"_id":"59c4267267a94900103a25b2","category":"59c4267167a94900103a2562","parentDoc":null,"project":"55d2023b3c74062300aee506","user":"55d201fe945e481700afbb19","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-09-03T00:50:00.634Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"name":"","status":200,"language":"json","code":"{}"},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":14,"body":"To ensure quality of service, multiple rate limits are applied per API key that affect different time intervals (e.g. per second, per hour) and types of requests (e.g. reads, writes). You can determine the rate limit status of your API key by requesting [Retrieve Rate Limits](doc:retrieve-rate-limits). It returns a paginated list of [Rate Limit Objects](doc:the-rate-limit-object) that describe the different rate limits applied to your API key. Each [object](doc:the-rate-limit-object) contains information about the types of requests it applies to, the length of the interval, how many requests are remaining in the interval, and when the interval resets:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"data\\\": [\\n    {\\n      \\\"request_type\\\": \\\"all\\\",\\n      \\\"interval\\\": 1, \\n      \\\"limit\\\": 40,\\n      \\\"remaining\\\": 10,\\n      \\\"reset\\\": \\\"2013-05-17T02:30:22+00:00\\\"\\n    },\\n    {\\n      \\\"request_type\\\": \\\"all\\\",\\n      \\\"interval\\\": 86400, \\n      \\\"limit\\\": 10000,\\n      \\\"remaining\\\": 2398,\\n      \\\"reset\\\": \\\"2013-05-17T02:30:00+00:00\\\"\\n    },\\n    {\\n      \\\"request_type\\\": \\\"write\\\",\\n      \\\"interval\\\": 360, \\n      \\\"limit\\\": 2000,\\n      \\\"remaining\\\": 102,\\n      \\\"reset\\\": \\\"2013-05-17T04:30:22+00:00\\\"\\n    }    \\n  ],\\n  \\\"next_page_url\\\": null,\\n  \\\"total_count\\\": 3\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nCurrently, rate limits can be applied to the following types of requests:\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Request type\",\n    \"h-1\": \"Applies to...\",\n    \"0-0\": \"`all`\",\n    \"1-0\": \"`write`\",\n    \"0-1\": \"All requests\",\n    \"1-1\": \"POST, PUT, PATCH, and DELETE requests\"\n  },\n  \"cols\": 2,\n  \"rows\": 2\n}\n[/block]\nIf you're rate limited, the PlanGrid API returns a 429 with a JSON body that includes a [Rate Limit Object](doc:the-rate-limit-object) containing information about the rate limit that was hit:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"message\\\": \\\"API rate limit exceeded for developer cffe0ebb-2017-44d6-98d0-ddb0d48a3da8.\\\",\\n  \\\"rate_limit\\\": {\\n    \\\"request_type\\\": \\\"write\\\",\\n    \\\"interval\\\": 360, \\n    \\\"limit\\\": 2000,\\n    \\\"remaining\\\": 102,\\n    \\\"reset\\\": \\\"2013-05-17T04:30:22+00:00\\\"\\n  }\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nYou can use the [Rate Limit Object](doc:the-rate-limit-object) to programmatically retry a rate limited request at the exact moment the rate limit resets. The example code below demonstrates this; it gets a list of all accessible projects and retries retrieval of a page of results if the request is rate limited:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"import datetime\\nfrom time import sleep\\n\\nimport dateutil.parser\\nimport pytz\\nimport requests\\n\\napi_prefix = 'https://io.plangrid.com'\\napi_key = '[[app:key]]'\\nversion_headers = {'Accept': 'application/vnd.plangrid+json; version=1'}\\n\\ndef get_projects():\\n    # Get all of a user's projects from the API\\n    all_projects = []\\n    projects_url = '{}/projects'.format(api_prefix)\\n    while projects_url is not None:\\n        response = requests.get(projects_url, auth=(api_key, None), headers=version_headers)\\n\\n        if response.status_code == 200:\\n            # Save the projects that were successfully retrieved and go to the next page\\n            projects = response.json()['data']\\n            all_projects += projects\\n            projects_url = response.json()['next_page_url']\\n\\n        elif response.status_code == 429:\\n            # Sleep until the rate limit has expired, then retry the same request\\n            now = datetime.datetime.now(tz=pytz.utc)\\n            reset_iso_format = response.json()['rate_limit']['reset']\\n            reset = dateutil.parser.parse(reset_iso_format)\\n            seconds_to_sleep = (reset - now).total_seconds()\\n            sleep(seconds_to_sleep)\\n\\n    return all_projects\\n\\n# Example\\nprojects = get_projects()\\n\\nprint projects\",\n      \"language\": \"python\"\n    }\n  ]\n}\n[/block]\nIf you’re consistently rate limited, please [contact support](mailto:developers@plangrid.com) to see if your rate limits can be increased.","excerpt":"Happy responses come from happy servers.","slug":"rate-limiting","type":"basic","title":"Rate Limiting","__v":0,"childrenPages":[]}

{"_id":"59c4267267a94900103a25b3","category":"59c4267167a94900103a2562","parentDoc":null,"project":"55d2023b3c74062300aee506","user":"55d201fe945e481700afbb19","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-09-22T07:02:52.834Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"auth":"required","params":[],"url":""},"isReference":false,"order":15,"body":"Any timestamps contained in the JSON response are represented as strings in [ISO 8601](http://www.w3.org/TR/NOTE-datetime) format with timezone set to [UTC](https://en.wikipedia.org/wiki/Coordinated_Universal_Time):\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"YYYY-MM-DDThh:mm:SS+00:00\",\n      \"language\": \"text\"\n    }\n  ]\n}\n[/block]\nDates are of the form:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"YYYY-MM-DD\",\n      \"language\": \"text\"\n    }\n  ]\n}\n[/block]\nYou will need to perform timezone conversions in your client.","excerpt":"It's always tea-time.","slug":"timestamps-and-timezones","type":"basic","title":"Timestamps and Timezones","__v":0,"childrenPages":[]}

{"_id":"59c4267267a94900103a25b4","category":"59c4267167a94900103a2562","project":"55d2023b3c74062300aee506","user":"55d201fe945e481700afbb19","parentDoc":null,"version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-11-06T04:05:12.386Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"name":"","status":400,"language":"json","code":"{}"}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":16,"body":"Every record stored in PlanGrid is assigned a *universally*\\* unique identifier (`uid`) that will not change. UIDs are strings with four dashes between thirty-two alphanumeric characters: `“cce19790-2f7b-46fc-ade0-c932181c35d9”`. You can safely use the PlanGrid `uid` when mapping PlanGrid records with another system’s records.\n\n<sub>* The two exceptions are the [RFI status record](doc:the-rfi-status-object) and [permission role record](doc:the-role-object). For RFI status records, the unique identifiers are strings with 8 alphanumeric characters (`'4898bfd4'`). The unique identifiers for permission role records are strings with four dashes between thirty-two alphanumeric characters (`'17dce2c5-4931-47e7-8c98-84b35f00ba03'`) but are _not_ universally unique.</sub>","excerpt":"You're special.","slug":"unique-identifiers","type":"basic","title":"Unique Identifiers","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a259d","category":"59c4267167a94900103a2563","parentDoc":null,"project":"55d2023b3c74062300aee506","user":"55d201fe945e481700afbb19","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-12-21T01:31:10.928Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"language":"json","status":400,"name":"","code":"{}"}]},"auth":"required","params":[],"url":""},"isReference":false,"order":17,"body":"When uploading files via PlanGrid's API, this object is returned after the first step and contains information necessary for subsequent steps. See [File Uploads](doc:file-uploads) for details.\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"**uid**\\n`string`\",\n    \"4-0\": \"**webhook_url**\\n`string`\",\n    \"0-1\": \"The unique identifier that will be assigned to the record associated with the file (e.g. Attachment, Photo). Never blank. See [Unique Identifiers](doc:unique-identifiers) for details.\",\n    \"4-1\": \"Once the file is uploaded, the URL to GET to complete creation of the record. Amazon S3 automatically redirects to this URL once the upload is complete.\",\n    \"h-0\": \"Attribute\",\n    \"h-1\": \"Description\",\n    \"1-0\": \"**aws_post_form_arguments**\\n`object`\",\n    \"1-1\": \"Necessary information to securely POST file to Amazon S3.\",\n    \"2-1\": \"The private URL to POST the file and security fields to.\",\n    \"2-0\": \"**aws_post_form_arguments.action**\\n`string`\",\n    \"3-0\": \"**aws_post_form_arguments.fields**\\n`array`\",\n    \"3-1\": \"An array of ordered key-value pairs for the POST form fields that authenticate you with Amazon S3.\"\n  },\n  \"cols\": 2,\n  \"rows\": 5\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"  {\\n    \\\"uid\\\": \\\"022c132d-cdd0-48a1-8874-d4c9fd310ec8\\\",\\n    \\\"webhook_url\\\": \\\"https://io.plangrid.com/projects/4d0f4ff6-b4e7-fb41-edb2-139b0fff9ef7/attachments/uploads/completions/8392cd3fbf2dfbf9fc539c8423a21201\\\",\\n    \\\"aws_post_form_arguments\\\": {\\n      \\\"action\\\": \\\"https://plangrid-attachments.s3.amazonaws.com/\\\",\\n      \\\"fields\\\": [\\n        {\\n          \\\"name\\\": \\\"key\\\",\\n          \\\"value\\\": \\\"4d0f4ff6-b4e7-fb41-edb2-139b0fff9ef7\\\\/1ab29ace-adfe-4ff0-b4bd-267ca612df9a_ff\\\"\\n        },\\n        {\\n          \\\"name\\\": \\\"AWSAccessKeyId\\\",\\n          \\\"value\\\": \\\"AKIAIWKPH7OCNIEE5GGQ\\\"\\n        },\\n        {\\n          \\\"name\\\": \\\"success_action_redirect\\\",\\n          \\\"value\\\": \\\"https:\\\\/\\\\/plangrid-c-api-dispatcher-test.herokuapp.com\\\\/projects\\\\/4d0f4ff6-b4e7-fb41-edb2-139b0fff9ef7\\\\/attachments\\\\/uploads\\\\/completions\\\\/1039b3921a93c7e74bdb3352779c2c6e\\\"\\n        },\\n        {\\n          \\\"name\\\": \\\"policy\\\",\\n          \\\"value\\\": \\\"eyJleHBpcmF0aW9uIjogIjIwMTUtMTItMjJUMjE6MTU6MTlaIiwKImNvbmRpdGlvbnMiOiBbeyJDb250ZW50LVR5cGUiOiAiYXBwbGljYXRpb24vcGRmIn0seyJidWNrZXQiOiAibG91cGUtdGVzdC1hdHRhY2gifSx7ImtleSI6ICI0ZDBmNGZmNi1iNGU3LWZiNDEtZWRiMi0xMzliMGZmZjllZjcvMWFiMjlhY2UtYWRmZS00ZmYwLWI0YmQtMjY3Y2E2MTJkZjlhX2ZmIn0seyJzdWNjZXNzX2FjdGlvbl9yZWRpcmVjdCI6ICJodHRwczovL3BsYW5ncmlkLWMtYXBpLWRpc3BhdGNoZXItdGVzdC5oZXJva3VhcHAuY29tL3YxL3Byb2plY3RzLzRkMGY0ZmY2LWI0ZTctZmI0MS1lZGIyLTEzOWIwZmZmOWVmNy9hdHRhY2htZW50cy91cGxvYWRzL2NvbXBsZXRpb25zLzEwMzliMzkyMWE5M2M3ZTc0YmRiMzM1Mjc3OWMyYzZlIn0seyJ4LWFtei1zdG9yYWdlLWNsYXNzIjogIlNUQU5EQVJEIn0seyJ4LWFtei1zZXJ2ZXItc2lkZS1lbmNyeXB0aW9uIjogIkFFUzI1NiJ9XX0=\\\"\\n        },\\n        {\\n          \\\"name\\\": \\\"signature\\\",\\n          \\\"value\\\": \\\"CztWq\\\\/9IU4hCaEiaw0P5IRYmh0g=\\\"\\n        },\\n        {\\n          \\\"name\\\": \\\"Content-Type\\\",\\n          \\\"value\\\": \\\"application\\\\/pdf\\\"\\n        },\\n        {\\n          \\\"name\\\": \\\"x-amz-storage-class\\\",\\n          \\\"value\\\": \\\"STANDARD\\\"\\n        },\\n        {\\n          \\\"name\\\": \\\"x-amz-server-side-encryption\\\",\\n          \\\"value\\\": \\\"AES256\\\"\\n        }\\n      ]\\n    }\\n  }\",\n      \"language\": \"json\"\n    }\n  ],\n  \"sidebar\": true\n}\n[/block]","excerpt":"","slug":"the-file-upload-object","type":"basic","title":"The File Upload Object","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a259e","category":"59c4267167a94900103a2563","parentDoc":null,"user":"55d201fe945e481700afbb19","project":"55d2023b3c74062300aee506","version":"59c4267167a94900103a2560","updates":["57b32e995800cc0e00b3c035"],"next":{"pages":[],"description":""},"createdAt":"2016-07-11T21:32:46.872Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":18,"body":"When generating a sheet packet, issue report, or any other shareable file, PlanGrid kicks off an asynchronous process to generate the file. To help you track when the file has been successfully generated, the PlanGrid API returns an object that gives you the current status and relevant URLs.\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"**uid**\\n`string`\",\n    \"0-1\": \"The unique identifier assigned to the shareable object. Never blank. See [Unique Identifiers](doc:unique-identifiers) for details.\",\n    \"h-0\": \"Attribute\",\n    \"h-1\": \"Description\",\n    \"1-0\": \"**file_url**\\n`string`\",\n    \"1-1\": \"URL to retrieve the shareable file.\",\n    \"3-0\": \"**status**\\n`string`\",\n    \"3-1\": \"Status of the shareable. Possible values are: \\\"incomplete\\\", \\\"complete\\\", \\\"errored\\\".\",\n    \"2-0\": \"**resource**\\n`object`\",\n    \"2-1\": \"Reference to itself (e.g. `this`, `self`). See [Foreign Keys](doc:foreign-keys) for attribute details.\"\n  },\n  \"cols\": 2,\n  \"rows\": 4\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"uid\\\": \\\"92cf7193-af0c-42fc-a3ab-7ef5149da720\\\",\\n  \\\"file_url\\\": \\\"https://packet-assets.plangrid.com/92cf7193-af0c-42fc-a3ab-7ef5149da720.pdf\\\",\\n  \\\"resource\\\": {\\n    \\\"uid\\\": \\\"92cf7193-af0c-42fc-a3ab-7ef5149da720\\\",\\n    \\\"url\\\": \\\"https://io.plangrid.com/projects/da48fcc3-7af1-4fd6-a083-70195468718a/sheets/packets/92cf7193-af0c-42fc-a3ab-7ef5149da720\\\"\\n  },\\n  \\\"status\\\": \\\"incomplete\\\"\\n}\",\n      \"language\": \"json\"\n    }\n  ],\n  \"sidebar\": true\n}\n[/block]","excerpt":"","slug":"the-shareable-object","type":"basic","title":"The Shareable Object","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a2591","category":"59c4267167a94900103a2564","parentDoc":null,"project":"55d2023b3c74062300aee506","user":"57db49de0678030e008a76f8","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-01-27T22:11:44.403Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"code":"{}","language":"json","status":200,"name":""},{"status":400,"name":"","code":"{}","language":"json"}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":19,"body":"A batch request allows you to send multiple API requests at a single time. This can help you avoid rate limits for actions that need to be repeated multiple times. Examples of when you might want to use batch requests include: \n* adding multiple users at a time to a project\n* requesting issues from multiple projects\n* requesting records across multiple pages of an endpoint\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Formatting a batch request\"\n}\n[/block]\nTo make a batch request, you must provide an array of requests and `POST` it to the `/batch` endpoint. Each request inside the batch request contains its own `method` and `path`, as well as a JSON-encoded `body` if required. Each request in the batch uses the same `Authorization`, `Content-Type` and `Accept` headers from the batch request but can be overwritten within the headers of that request.\n\nThe example below shows a batched request to retrieve a specific project with UID `43b198bb-d4f9-c302-9173-271050e424b7` and also create a new project named `test_create`.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"[\\n  {\\n    \\\"method\\\": \\\"GET\\\",\\n    \\\"path\\\": \\\"/projects/43b198bb-d4f9-c302-9173-271050e424b7\\\" \\n  },\\n  {\\n    \\\"method\\\": \\\"POST\\\",\\n    \\\"path\\\": \\\"/projects\\\",\\n    \\\"headers\\\": [\\n      {\\n        \\\"name\\\": \\\"Content-Type\\\",\\n        \\\"value\\\": \\\"application/json\\\"\\n      }\\n    ],\\n    \\\"body\\\": \\\"{\\\\\\\"name\\\\\\\": \\\\\\\"test_create\\\\\\\"}\\\"\\n  },\\n  {\\n    \\\"method\\\": \\\"POST\\\",\\n    \\\"path\\\": \\\"/projects\\\",\\n    \\\"headers\\\": [\\n      {\\n        \\\"name\\\": \\\"Content-Type\\\",\\n        \\\"value\\\": \\\"application/json\\\"\\n      }\\n    ],\\n    \\\"body\\\": \\\"{}\\\"\\n  }\\n]\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Response from a batch request\"\n}\n[/block]\nOnce a batch request is successfully completed, you will receive a single response that contains the results for all requests (in the same order as the original request). Each response contains its own `status_code` and a JSON-encoded `body`. For instance, the example above yields the following response that includes both `200` and `400` responses.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"data\\\": [\\n    {\\n      \\\"status_code\\\": 200,\\n      \\\"headers\\\": [\\n        {\\n          \\\"name\\\": \\\"connection\\\",\\n          \\\"value\\\": \\\"close\\\",\\n        },\\n        {\\n          \\\"name\\\": \\\"content-type\\\",\\n          \\\"value\\\": \\\"application/json\\\"\\n        }\\n      ],\\n      \\\"body\\\": \\\"{\\\\\\\"uid\\\\\\\": \\\\\\\"43b198bb-d4f9-c302-9173-271050e424b7\\\\\\\", \\\\\\\"name\\\\\\\": \\\\\\\"1000 Issues\\\\\\\"}\\\"\\n    },\\n    {\\n      \\\"status_code\\\": 200,\\n      \\\"headers\\\": [\\n        {\\n          \\\"name\\\": \\\"connection\\\",\\n          \\\"value\\\": \\\"close\\\",\\n        },\\n        {\\n          \\\"name\\\": \\\"content-type\\\",\\n          \\\"value\\\": \\\"application/json\\\"\\n        }\\n      ],\\n      \\\"body\\\": \\\"{\\\\\\\"uid\\\\\\\": \\\\\\\"880597f4-c15b-4b95-8c32-0cdefdc1a091\\\\\\\", \\\\\\\"name\\\\\\\": \\\\\\\"test_create\\\\\\\"}\\\"\\n    },\\n    {\\n      \\\"status_code\\\": 400,\\n      \\\"headers\\\": [\\n        {\\n          \\\"name\\\": \\\"connection\\\",\\n          \\\"value\\\": \\\"close\\\",\\n        },\\n        {\\n          \\\"name\\\": \\\"content-type\\\",\\n          \\\"value\\\": \\\"application/json\\\"\\n        }\\n      ],\\n      \\\"body\\\": \\\"{\\\\\\\"message\\\\\\\": \\\\\\\"Fields must be in JSON body.\\\\\\\"}\\\"\\n    }\\n]\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nPlease note that if you provide a malformed array, an array with too many requests, or an array with no requests, you will receive a `400` response for the batch request instead of a response like the one above. See the various errors in the [Send Batch Request](doc:send-batch-request) example.","excerpt":"","slug":"why-batch-requests","type":"basic","title":"Why Batch Requests?","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a2592","category":"59c4267167a94900103a2564","project":"55d2023b3c74062300aee506","user":"57db49de0678030e008a76f8","parentDoc":null,"version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-01-25T01:32:45.513Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"name":"","code":"{}","language":"json"},{"language":"json","status":400,"name":"","code":"{}"}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":20,"body":"[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"**status_code**\\n`integer`\",\n    \"1-0\": \"**headers**\\n`array`\",\n    \"4-0\": \"**body**\\n`string`\",\n    \"0-1\": \"The HTTP status code for this response.\",\n    \"1-1\": \"The headers for this response.\",\n    \"4-1\": \"The JSON-encoded body for this response.\",\n    \"2-0\": \"**headers.name**\\n`string`\",\n    \"2-1\": \"The name of the header.\",\n    \"3-0\": \"**headers.value**\\n`string`\",\n    \"3-1\": \"The value of the header.\",\n    \"h-0\": \"Attribute\",\n    \"h-1\": \"Description\"\n  },\n  \"cols\": 2,\n  \"rows\": 5\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"status_code\\\": 200,\\n  \\\"headers\\\": [\\n    {\\n      \\\"name\\\": \\\"connection\\\",\\n      \\\"value\\\": \\\"close\\\",\\n    },\\n    {\\n      \\\"name\\\": \\\"content-type\\\",\\n      \\\"value\\\": \\\"application/json\\\"\\n    }\\n  ],\\n  \\\"body\\\": \\\"{\\\\\\\"uid\\\\\\\": \\\\\\\"43b198bb-d4f9-c302-9173-271050e424b7\\\\\\\", \\\\\\\"name\\\\\\\": \\\\\\\"1000 Issues\\\\\\\"}\\\"\\n}\",\n      \"language\": \"json\"\n    }\n  ],\n  \"sidebar\": true\n}\n[/block]","excerpt":"","slug":"the-batch-request-object","type":"basic","title":"The Batch Request Object","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a2593","category":"59c4267167a94900103a2564","parentDoc":null,"project":"55d2023b3c74062300aee506","user":"57db49de0678030e008a76f8","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-01-27T22:45:53.775Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"method":"post","results":{"codes":[{"status":200,"language":"json","code":"{\n  \"data\": [\n    {\n      \"status_code\": 200,\n      \"headers\": [\n        {\n          \"name\": \"connection\",\n          \"value\": \"close\",\n        },\n        {\n          \"name\": \"content-type\",\n          \"value\": \"application/json\"\n        }\n      ],\n      \"body\": \"{\\\"uid\\\": \\\"43b198bb-d4f9-c302-9173-271050e424b7\\\", \\\"name\\\": \\\"1000 Issues\\\"}\"\n    },\n    {\n      \"status_code\": 400,\n      \"headers\": [\n        {\n          \"name\": \"connection\",\n          \"value\": \"close\",\n        },\n        {\n          \"name\": \"content-type\",\n          \"value\": \"application/json\"\n        }\n      ],\n      \"body\": \"{\\\"message\\\": \\\"Request body must be a JSON encoded string.\\\"}\"\n    },\n    {\n      \"status_code\": 400,\n      \"headers\": [\n        {\n          \"name\": \"connection\",\n          \"value\": \"close\",\n        },\n        {\n          \"name\": \"content-type\",\n          \"value\": \"application/json\"\n        }\n      ],\n      \"body\": \"{\\\"message\\\": \\\"Request must contain at least one field.\\\"}\"\n    },\n    {\n      \"status_code\": 400,\n      \"headers\": [\n        {\n          \"name\": \"connection\",\n          \"value\": \"close\",\n        },\n        {\n          \"name\": \"content-type\",\n          \"value\": \"application/json\"\n        }\n      ],\n      \"body\": \"{\\\"message\\\": \\\"Unsupported fields are not allowed in request.\\\"}\"\n    },\n    {\n      \"status_code\": 400,\n      \"headers\": [\n        {\n          \"name\": \"connection\",\n          \"value\": \"close\",\n        },\n        {\n          \"name\": \"content-type\",\n          \"value\": \"application/json\"\n        }\n      ],\n      \"body\": \"{\\\"message\\\": \\\"Method required to send batch request.\\\"}\"\n    },\n    {\n      \"status_code\": 400,\n      \"headers\": [\n        {\n          \"name\": \"connection\",\n          \"value\": \"close\",\n        },\n        {\n          \"name\": \"content-type\",\n          \"value\": \"application/json\"\n        }\n      ],\n      \"body\": \"{\\\"message\\\": \\\"Path required to send batch request.\\\"}\"\n    },\n    {\n      \"status_code\": 400,\n      \"headers\": [\n        {\n          \"name\": \"connection\",\n          \"value\": \"close\",\n        },\n        {\n          \"name\": \"content-type\",\n          \"value\": \"application/json\"\n        }\n      ],\n      \"body\": \"{\\\"message\\\": \\\"Path must begin with a '/'.\\\"}\"\n    },\n    {\n      \"status_code\": 400,\n      \"headers\": [\n        {\n          \"name\": \"connection\",\n          \"value\": \"close\",\n        },\n        {\n          \"name\": \"content-type\",\n          \"value\": \"application/json\"\n        }\n      ],\n      \"body\": \"{\\\"message\\\": \\\"Headers must be an array of objects with 'name' and 'value'.\\\"}\"\n    },\n    {\n      \"status_code\": 400,\n      \"headers\": [\n        {\n          \"name\": \"connection\",\n          \"value\": \"close\",\n        },\n        {\n          \"name\": \"content-type\",\n          \"value\": \"application/json\"\n        }\n      ],\n      \"body\": \"{\\\"message\\\": \\\"Unsupported fields are not allowed in headers.\\\"}\"\n    },\n    {\n      \"status_code\": 500,\n      \"headers\": [\n        {\n          \"name\": \"connection\",\n          \"value\": \"close\",\n        },\n        {\n          \"name\": \"content-type\",\n          \"value\": \"application/json\"\n        }\n      ],\n      \"body\": \"{\\\"message\\\": \\\"Sorry, PlanGrid's system had an error and the team has been notified. If this happens again, please contact support@plangrid.com.\\\"}\"\n    }\n  ]\n}","name":""},{"name":"No Requests","status":400,"language":"json","code":"{ \"message\": \"There must be at least one batch request.\" }"},{"name":"Too Many Requests","status":400,"language":"json","code":"{ \"message\": \"The number of batch requests (:number_of_requests) must be less than or equal to 50.\" }"},{"name":"Not An Array","status":400,"language":"json","code":"{ \"message\": \"JSON body must be an array.\" }"}]},"settings":"588bb90f33b1b337002e64e7","auth":"required","params":[],"url":"/batch"},"isReference":false,"order":21,"body":"The following example shows how to retrieve your projects and rate limits in one request.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -i https://io.plangrid.com/batch -u [[app:key]]: -H \\\"Content-Type: application/json\\\" -H 'Accept: application/vnd.plangrid+json; version=1' -d '[{\\\"method\\\": \\\"GET\\\", \\\"path\\\": \\\"/projects\\\"}, {\\\"method\\\": \\\"GET\\\", \\\"path\\\": \\\"/rate_limits\\\"}]' -v\",\n      \"language\": \"curl\"\n    }\n  ]\n}\n[/block]\nThe following example shows how to retrieve project data from multiple endpoints.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"import requests\\n\\napi_prefix = 'https://io.plangrid.com'\\napi_key = '[[app:key]]'\\nversion_headers = {'Accept': 'application/vnd.plangrid+json; version=1'}\\n\\ndef get_first_project_uid():\\n    # Get the UID of the first project returned from the API\\n    projects_url = '{}/projects'.format(api_prefix)\\n    response = requests.get(projects_url, auth=(api_key, None), headers=version_headers)\\n    projects = response.json()['data']\\n    first_project_uid = projects[0]['uid']\\n    return first_project_uid\\n\\ndef get_project_data(project_uid):\\n    project_paths = [\\n        \\\"/projects/{}\\\".format(project_uid),\\n        \\\"/projects/{}/attachments\\\".format(project_uid),\\n        \\\"/projects/{}/comments\\\".format(project_uid),\\n        \\\"/projects/{}/issues\\\".format(project_uid),\\n        \\\"/projects/{}/photos\\\".format(project_uid),\\n        \\\"/projects/{}/rfis\\\".format(project_uid),\\n        \\\"/projects/{}/roles\\\".format(project_uid),\\n        \\\"/projects/{}/sheets\\\".format(project_uid),\\n        \\\"/projects/{}/snapshots\\\".format(project_uid),\\n        \\\"/projects/{}/users\\\".format(project_uid)\\n    ]\\n\\n    batch_requests = []\\n    for path in project_paths:\\n        batch_requests.append({\\n            \\\"method\\\": \\\"GET\\\",\\n            \\\"path\\\": path\\n        })\\n\\n    batch_url = '{}/batch'.format(api_prefix)\\n    response = requests.post(url=batch_url, auth=(api_key, None), headers=version_headers, json=batch_requests)\\n\\n    json_response = response.json()['data']\\n\\n    return json_response\\n\\n# Get a project_uid for the batch\\nproject_uid = get_first_project_uid()\\n\\n# Perform a batch request\\nproject_data = get_project_data(project_uid=project_uid)\\n\\nprint project_data\",\n      \"language\": \"python\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"send-batch-request","type":"post","title":"Send Batch Request","__v":0,"childrenPages":[]}

{"_id":"59c4267267a94900103a25d7","category":"59c4267167a94900103a2565","parentDoc":null,"project":"55d2023b3c74062300aee506","user":"57db49de0678030e008a76f8","version":"59c4267167a94900103a2560","updates":["5929fc5db1061c1900f8f0b4"],"next":{"pages":[],"description":""},"createdAt":"2017-02-16T21:15:07.278Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"code":"{}","language":"json","status":400,"name":""}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":22,"body":"The PlanGrid API supports [OAuth 2.0](https://oauth.net/2/) as a protocol of authentication and authorization. OAuth 2.0 is an industry-standard protocol that allows third-party applications to obtain authorization to a user's data on their behalf. \n\n[Client libraries](https://oauth.net/code/#client-libraries) are also available to help you quickly develop applications based on the OAuth standards.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Before you begin\",\n  \"body\": \"You must register your application before you can start using OAuth with our API. If you are a developer looking to use OAuth, please [contact us](mailto:developers@plangrid.com) to register your application. You will need to provide the following information: application name, logo, and a list of redirect URIs.\"\n}\n[/block]\nWe support the **authorization code** and **implicit** grant types. You can read more below about each grant type and how to get started with the appropriate OAuth flow in your application.","excerpt":"","slug":"getting-started-with-oauth","type":"basic","title":"Getting Started with OAuth","__v":0,"childrenPages":[]}

{"_id":"59c4267267a94900103a25d8","category":"59c4267167a94900103a2565","project":"55d2023b3c74062300aee506","user":"57db49de0678030e008a76f8","parentDoc":null,"version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-08-04T19:43:53.454Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"code":"{}","language":"json","status":400,"name":""}]},"auth":"required","params":[],"url":""},"isReference":false,"order":23,"body":"The **authorization code** grant type is a redirection-based flow most commonly used with server-side applications that can interact with the user-agent. If using this grant type, your application must be able to secure the client secret. This flow will provide both an access token and a refresh token.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"1. Request user authorization\"\n}\n[/block]\nDirect your users to the `/oauth/authorize` endpoint with the `response_type` set to `code` and following parameters:\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Name\",\n    \"h-1\": \"Description\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"**client_id**\\n`string`\\n*Required* \",\n    \"0-1\": \"A unique identifier for your application provided by PlanGrid.\",\n    \"2-0\": \"**scope**\\n`string`\",\n    \"3-0\": \"**redirect_uri**\\n`string`\",\n    \"2-1\": \"Specify a group of resources an application can request access to. See [OAuth Scopes](doc:oauth-scopes) for details.\",\n    \"1-0\": \"**state**\\n`string`\\n*Required*\",\n    \"1-1\": \"An arbitrary string that will be included in the response. This can be used to confirm that the request originated from your application.\",\n    \"3-1\": \"Specify a URL where the response will be redirected. Must match a value in the whitelist for this client.\"\n  },\n  \"cols\": 2,\n  \"rows\": 4\n}\n[/block]\nAn example request would look like the following:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"https://io.plangrid.com/oauth/authorize?response_type=code&client_id=MY_CLIENT_ID&state=SECURITY_TOKEN\",\n      \"language\": \"http\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"State:\",\n  \"body\": \"As a security best practice, we recommend all client applications use a security token as the `state` parameter to prevent cross-site request forgery and other similar attacks on your application and users.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"2. User authorizes your application\"\n}\n[/block]\nThe user will be directed to PlanGrid to authorize your application. Any errors will be displayed to the user.\n\nThe user must authorize your application to access the information defined in the request `scope`.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/c966013-Screen_Shot_2017-02-17_at_2.59.38_PM.png\",\n        \"Screen Shot 2017-02-17 at 2.59.38 PM.png\",\n        1152,\n        1116,\n        \"#0c70b4\"\n      ]\n    }\n  ]\n}\n[/block]\nAfter authorizing your application, the user-agent will be redirected to the `redirect_uri` along with an authorization code as a query parameter. For example, if your `redirect_uri` is `https://myapplication.com/callback`, the redirect will look like the following:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"https://myapplication.com/callback?code=AUTHORIZATION_CODE&state=SECURITY_TOKEN\",\n      \"language\": \"http\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"3. Request access token\"\n}\n[/block]\nThe authorization code from the previous step can be used to retrieve the access token. To do so, you must `POST` to the `/oauth/token` endpoint with the parameters below. The request must be a URL encoded body with the header `Content-Type: application/x-www-form-urlencoded`.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Name\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"**client_id**\\n`string`\\n*Required*\",\n    \"1-0\": \"**client_secret**\\n`string`\\n*Required*\",\n    \"3-0\": \"**code**\\n`string`\",\n    \"1-1\": \"A unique string for your application provided by PlanGrid.\",\n    \"0-1\": \"A unique identifier for your application provided by PlanGrid.\",\n    \"2-0\": \"**grant_type**\\n`string`\\n*Required*\",\n    \"5-0\": \"**redirect_uri**\\n`string`\",\n    \"2-1\": \"Type of request. Can be either `authorization_code` or `refresh_token`.\",\n    \"3-1\": \"Required if `grant_type` is set to `authorization_code`. Must be the authorization code acquired from the `/oauth/authorize` endpoint.\",\n    \"5-1\": \"If a `redirect_uri` was provided when requesting user authorization, this must match that value.\",\n    \"4-0\": \"**refresh_token**\\n`string`\",\n    \"4-1\": \"Required if `grant_type` is set to `refresh_token`. Must be the `refresh_token` provided with access token.\"\n  },\n  \"cols\": 2,\n  \"rows\": 6\n}\n[/block]\nBelow is an example of a response from a successful request:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"refresh_token\\\": \\\"1d6f8598-f55e-11e6-bc64-92361f002671\\\",\\n  \\\"access_token\\\": \\\"bb4e2271-e99c-4f66-bc1e-698ffd744f33\\\",\\n  \\\"token_type\\\": \\\"bearer\\\",\\n  \\\"expires_in\\\":  604800\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"4. Using access token\"\n}\n[/block]\nNow that you have an access token, your application can perform API requests on behalf of the user. Your header must include `Authorization: Bearer access_token` with the `access_token` from the previous steps.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl https://io.plangrid.com/projects -H \\\"Authorization: Bearer access_token\\\"\",\n      \"language\": \"curl\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"5. Refreshing accessing tokens\"\n}\n[/block]\nAccess tokens will periodically expire. You can use the `refresh_token` to request a new access token when that happens. This avoids forcing your user to re-authorize your application.\n\nTo request a new access token, you must `POST` to the `/oauth/token` endpoint with the `grant_type` parameter set to `refresh_token` and pass in the `refresh_token` as the value for the `refresh_token` parameter. If successful, you will receive a new `access_token`.","excerpt":"","slug":"authorization-code-grant-type","type":"basic","title":"Grant Type: Authorization Code","__v":0,"childrenPages":[]}

{"_id":"59c4267267a94900103a25d9","category":"59c4267167a94900103a2565","project":"55d2023b3c74062300aee506","user":"57db49de0678030e008a76f8","parentDoc":null,"version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-08-03T21:51:03.069Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":24,"body":"The **implicit** grant type is commonly used for applications where the client secret cannot be kept confidential and instead relies on the redirect URI provided for the application. This flow will provide the access token directly to the application during the redirection and does not support refresh tokens.\n[block:api-header]\n{\n  \"title\": \"1. Request user authorization\"\n}\n[/block]\nDirect users to the `/oauth/authorize` endpoint with the following parameters and the `response_type` set to `token`.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Name\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"**client_id**\\n`string`\\n*Required* \",\n    \"0-1\": \"A unique identifier for your application provided by PlanGrid.\",\n    \"1-0\": \"**state**\\n`string`\\n*Required*\",\n    \"1-1\": \"An arbitrary string that will be included in the response. This can be used to confirm that the request originated from your application.\",\n    \"2-0\": \"**scope**\\n`string`\",\n    \"2-1\": \"Specify a group of resources an application can request access to. See [OAuth Scopes](doc:oauth-scopes) for details.\",\n    \"3-0\": \"**redirect_uri**\\n`string`\",\n    \"3-1\": \"Specify a URL where the response will be redirected. Must match a value in the whitelist for this client.\"\n  },\n  \"cols\": 2,\n  \"rows\": 4\n}\n[/block]\nAn example request would look like the following:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"https://io.plangrid.com/oauth/authorize?response_type=token&client_id=MY_CLIENT_ID&state=SECURITY_TOKEN&scope=read:profile\",\n      \"language\": \"http\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"2. User authorizes your application\"\n}\n[/block]\nThe user will be directed to PlanGrid to authorize application access to data as defined in the `scope`.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/711fc98-oauth-planet-express.png\",\n        \"oauth-planet-express.png\",\n        559,\n        531,\n        \"#0e72ba\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"3. User-agent receives access token\"\n}\n[/block]\nOnce the user authorizes your application, the user-agent will be directed to the redirect URI with the access token included in the URI fragment like so:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"https://myapplication.com/callback#access_token=oauth_23846885sd2d3c83796113f2dbaaf1d9&token_type=Bearer&expires_in=604800&state=SECURITY_TOKEN\",\n      \"language\": \"http\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"4. Using the access token\"\n}\n[/block]\nNow that your application has the access token, you can perform requests on behalf of the user by including the `Authorization: Bearer access_token` header in your calls to the API.","excerpt":"","slug":"implicit-grant-type","type":"basic","title":"Grant Type: Implicit","__v":0,"childrenPages":[]}

{"_id":"59c4267267a94900103a25da","category":"59c4267167a94900103a2565","project":"55d2023b3c74062300aee506","user":"57db49de0678030e008a76f8","parentDoc":null,"version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-08-16T20:06:44.729Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":25,"body":"Clients can specify the scope of access when requesting user authorization. Multiple scopes can be provided within a single request.\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Scope\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"**write:projects**\",\n    \"0-1\": \"Allows the application access to view and manage project data on your behalf. This is the default scope if none is provided during the authorization request.\",\n    \"1-0\": \"**read:profile**\",\n    \"1-1\": \"Allows the application access to view the user profile, including UID, first name, last name, and email. This scope is required to access the [User Profile](doc:the-user-profile-object).\"\n  },\n  \"cols\": 2,\n  \"rows\": 2\n}\n[/block]","excerpt":"","slug":"oauth-scopes","type":"basic","title":"OAuth Scopes","__v":0,"childrenPages":[]}

{"_id":"59c4267267a94900103a25db","category":"59c4267167a94900103a2565","project":"55d2023b3c74062300aee506","user":"57db49de0678030e008a76f8","parentDoc":null,"version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-08-16T19:37:29.213Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":26,"body":"[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Attribute\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"**access_token**\\n`string`\",\n    \"1-0\": \"**refresh_token**\\n`string`\",\n    \"2-0\": \"**token_type**\\n`string`\",\n    \"3-0\": \"**expires_in**\\n`integer`\",\n    \"4-0\": \"**scope**\\n`string`\",\n    \"0-1\": \"The access token.\",\n    \"4-1\": \"The scope of the access token as requested by the client. See [OAuth Scopes](doc:oauth-scopes) for details.\",\n    \"3-1\": \"The lifetime in seconds of the access token.\",\n    \"2-1\": \"The type of token issued.\",\n    \"1-1\": \"The refresh token can be used to obtain a new access token. Only provided with the [authorization code grant type](doc:authorization-code-grant-type).\"\n  },\n  \"cols\": 2,\n  \"rows\": 5\n}\n[/block]","excerpt":"","slug":"the-oauth-token-object","type":"basic","title":"The OAuth Token Object","__v":0,"childrenPages":[]}

{"_id":"59c4267267a94900103a25dc","category":"59c4267167a94900103a2565","project":"55d2023b3c74062300aee506","user":"57db49de0678030e008a76f8","parentDoc":null,"version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-02-13T19:12:16.646Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"method":"get","results":{"codes":[{"code":"","language":"text"}]},"settings":"588bb90f33b1b337002e64e7","auth":"required","params":[{"_id":"58a4dc2e9b78df19004ab10c","ref":"","in":"query","required":true,"desc":"A unique identifier for your application provided by PlanGrid.","default":"","type":"string","name":"client_id"},{"_id":"58a4dc2e9b78df19004ab10d","ref":"","in":"query","required":true,"desc":"Specify what grant type the endpoint returns. Use `code` for the authorization code flow or `token` for the implicit grant flow.","default":"","type":"string","name":"response_type"},{"_id":"58a4dc2e9b78df19004ab10b","ref":"","in":"query","required":true,"desc":"An arbitrary string that will be included in the response. This can be used to confirm that the request originated from your application.","default":"","type":"string","name":"state"},{"_id":"58a4dc2e9b78df19004ab10a","ref":"","in":"query","required":false,"desc":"Specify a group of resources an application can request access to. See [OAuth Scopes](doc:oauth-scopes) for details.","default":"","type":"string","name":"scope"},{"_id":"58a4dc2e9b78df19004ab109","ref":"","in":"query","required":false,"desc":"Specify a URL where the response will be redirected. Must match a value in the whitelist for this client.","default":"","type":"string","name":"redirect_uri"}],"url":"/oauth/authorize"},"isReference":false,"order":27,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Errors\",\n  \"sidebar\": true\n}\n[/block]\n\n[block:textarea]\n{\n  \"text\": \"If any error occurs during authorization, the user agent will be redirected to the redirect URI with one of the following error codes:\",\n  \"sidebar\": true\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"**invalid_request** \",\n    \"0-1\": \"The request is missing a required parameter, includes an invalid parameter, includes a parameter more than once, or is otherwise malformed.\",\n    \"1-0\": \"**unsupported_response_type**\",\n    \"1-1\": \"An unsupported response type was requested.\",\n    \"2-0\": \"**invalid_scope**\",\n    \"2-1\": \"An invalid scope was provided.\",\n    \"3-0\": \"**server_error**\",\n    \"3-1\": \"An uncaught exception occurred during authorization.\"\n  },\n  \"cols\": 2,\n  \"rows\": 4,\n  \"sidebar\": true\n}\n[/block]","excerpt":"Redirect the user to PlanGrid to authorize the application. The first of a multi-step process for authenticating with OAuth 2.0. Upon user authorization, an authorization or token code will be provided based on the grant type.","slug":"retrieve-authorization-code","type":"get","title":"Retrieve Authorization Code","__v":0,"childrenPages":[]}

{"_id":"59c4267267a94900103a25dd","category":"59c4267167a94900103a2565","parentDoc":null,"user":"57db49de0678030e008a76f8","project":"55d2023b3c74062300aee506","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-02-17T15:43:19.404Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"method":"post","results":{"codes":[{"name":"","status":200,"language":"json","code":"{\n  \"refresh_token\": \"a95b3fadb31941fe9b0a74cb71b721d\",\n  \"access_token\": \"oauth_8107f78b473e46dab2406cd4db3bb366\",\n  \"token_type\": \"Bearer\",\n  \"expires_in\":  604800,\n  \"scope\": \"write:projects\"\n}"}]},"settings":"58a619d52cb5710f0070d0de","auth":"required","params":[{"_id":"58a71aa0e29fd525004c9b1a","ref":"","in":"query","required":true,"desc":"A unique identifier for your application provided by PlanGrid.","default":"","type":"string","name":"client_id"},{"_id":"58a71aa0e29fd525004c9b19","ref":"","in":"query","required":true,"desc":"A unique string for your application provided by PlanGrid.","default":"","type":"string","name":"client_secret"},{"_id":"58a71aa0e29fd525004c9b1c","ref":"","in":"query","required":true,"desc":"Type of request. Can be either `authorization_code` or `refresh_token`.","default":"","type":"string","name":"grant_type"},{"_id":"58a71aa0e29fd525004c9b1b","ref":"","in":"query","required":false,"desc":"Required if `grant_type` is set to `authorization_code`. Must be the authorization code acquired from the `/oauth/authorize` endpoint.","default":"","type":"string","name":"code"},{"_id":"58e2e1f690f5250f0081e33d","ref":"","in":"query","required":false,"desc":"Required if `grant_type` is set to `refresh_token`. Must be the `refresh_token` provided with access token.","default":"","type":"string","name":"refresh_token"},{"_id":"58a71aa0e29fd525004c9b18","ref":"","in":"query","required":false,"desc":"If a `redirect_uri` was provided when requesting user authorization, this must match that value.","default":"","type":"string","name":"redirect_uri"}],"url":"/oauth/token"},"isReference":false,"order":28,"body":"","excerpt":"Once you have the `authorization_code` or a `refresh_token`, you can request the access token that will allow your application to perform API requests on behalf of the user.","slug":"retrieve-access-token","type":"post","title":"Retrieve Access Token","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a2587","category":"59c4267167a94900103a2566","user":"55d201fe945e481700afbb19","parentDoc":null,"project":"55d2023b3c74062300aee506","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-09-23T23:56:21.103Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"language":"json","status":200,"name":"","code":"{}"},{"code":"{}","language":"json","status":400,"name":""}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":29,"body":"[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Attribute\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"**uid**\\n`string`\",\n    \"0-1\": \"Never blank. See [Unique Identifiers](doc:unique-identifiers) for details.\",\n    \"1-0\": \"**name**\\n`string`\",\n    \"1-1\": \"Project name.\",\n    \"2-0\": \"**custom_id**\\n`string`\",\n    \"2-1\": \"Project code.\",\n    \"3-0\": \"**type**\\n`string`\",\n    \"3-1\": \"Project type with possible values of `general`, `manufacturing`, `power`, `water-sewer-waste`, `industrial-petroleum`, `transportation`, `hazardous-waste`, `telecom`, `education-k-12`, `education-higher`, `gov-federal`, `gov-state-local`, or `other`.\",\n    \"4-0\": \"**status**\\n`string`\",\n    \"4-1\": \"Project status.\",\n    \"5-0\": \"**owner**\\n`string`\",\n    \"5-1\": \"Project owner.\",\n    \"6-0\": \"**start_date**\\n`string`\",\n    \"6-1\": \"Project start date. ISO-8601 date format (YYYY-MM-DD).\",\n    \"7-0\": \"**end_date**\\n`string`\",\n    \"7-1\": \"Project end date. ISO-8601 date format (YYYY-MM-DD).\",\n    \"8-0\": \"**street_1**\\n`string`\",\n    \"8-1\": \"Project address, street line 1.\",\n    \"9-0\": \"**street_2**\\n`string`\",\n    \"9-1\": \"Project address, street line 2.\",\n    \"10-0\": \"**city**\\n`string`\",\n    \"10-1\": \"Project address town or city.\",\n    \"11-0\": \"**region**\\n`string`\",\n    \"11-1\": \"Project address state, province, or region.\",\n    \"12-0\": \"**postal_code**\\n`string`\",\n    \"12-1\": \"Project address zip or postal code.\",\n    \"13-0\": \"**country**\\n`string`\",\n    \"13-1\": \"Project address country in 2-letter ISO 3166 code.\"\n  },\n  \"cols\": 2,\n  \"rows\": 14\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"uid\\\": \\\"8510cfc9-2a82-4736-bf37-753c900d1c68\\\",\\n  \\\"name\\\": \\\"LA Natural History Museum\\\",\\n  \\\"custom_id\\\": \\\"5678\\\",\\n  \\\"type\\\": \\\"general\\\",\\n  \\\"status\\\": \\\"completed\\\",\\n  \\\"owner\\\": \\\"ACME\\\",\\n  \\\"start_date\\\": \\\"2001-10-01\\\",\\n  \\\"end_date\\\": \\\"2050-10-01\\\",\\n  \\\"street_1\\\": \\\"900 Exposition Blvd\\\",\\n  \\\"street_2\\\": null,\\n  \\\"city\\\": \\\"Los Angeles\\\",\\n  \\\"region\\\": \\\"California\\\",\\n  \\\"postal_code\\\": \\\"90007\\\",\\n  \\\"country\\\": \\\"US\\\"\\n}\",\n      \"language\": \"json\"\n    }\n  ],\n  \"sidebar\": true\n}\n[/block]","excerpt":"","slug":"the-project-object","type":"basic","title":"The Project Object","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a2588","category":"59c4267167a94900103a2566","parentDoc":null,"project":"55d2023b3c74062300aee506","user":"55d201fe945e481700afbb19","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-03-19T20:14:39.609Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"method":"post","results":{"codes":[{"code":"{\n  \"uid\": \"bafce976-8f33-437f-9c52-fb274456940f\",\n  \"name\": \"My New Construction Project.\",\n  \"custom_id\": \"1234\",\n  \"type\": \"general\",\n  \"status\": \"bidding\",\n  \"owner\": \"ACME\",\n  \"start_date\": \"2001-10-01\",\n  \"end_date\": \"2050-10-01\",\n  \"street_1\": \"350 5th Avenue\",\n  \"street_2\": null,\n  \"city\": \"New York\",\n  \"region\": \"New York\",\n  \"postal_code\": \"10118\",\n  \"country\": \"US\"  \n}\n","language":"json","status":201,"name":"Success"},{"name":"Name Missing","code":"{\n  \"message\": \"Project name required to create a project.\"\n}\n","language":"json","status":400},{"status":400,"name":"Name Blank","code":"{\n  \"message\": \"Project name must be at least one character long.\"\n}\n","language":"json"},{"name":"Invalid Custom ID","status":400,"language":"json","code":"{\n  \"message\": \"Custom ID must be null or a string at least one character long.\"\n}"},{"name":"Invalid Type","status":400,"language":"json","code":"{\n  \"message\": \"Type (2) must be a valid project type.\"\n}"},{"name":"Invalid Status","status":400,"language":"json","code":"{\n  \"message\": \"Status must be null or a string at least one character long.\"\n}"},{"code":"{\n  \"message\": \"Owner must be null or a string at least one character long.\"\n}","name":"Invalid Owner","status":400,"language":"json"},{"name":"Invalid Start Date","status":400,"language":"json","code":"{\n  \"message\": \"Start date (1234) must be null or a date string in ISO-8601 format (YYYY-MM-DD).\"\n}"},{"language":"json","code":"{\n  \"message\": \"End date (1234) must be null or a date string in ISO-8601 format (YYYY-MM-DD).\"\n}","name":"Invalid End Date","status":400},{"name":"Invalid Street 1","status":400,"language":"json","code":"{\n  \"message\": \"Street 1 must be null or a string at least one character long.\"\n}"},{"name":"Invalid Street 2","status":400,"language":"json","code":"{\n  \"message\": \"Street 2 must be null or a string at least one character long.\"\n}"},{"code":"{\n  \"message\": \"City must be null or a string at least one character long.\"\n}","name":"Invalid City","status":400,"language":"json"},{"name":"Invalid Region","status":400,"language":"json","code":"{\n  \"message\": \"Postal code must be null or a string at least one character long.\"\n}"},{"status":400,"name":"Invalid Country","code":"{\n  \"message\": \"Country must be an ISO 3166 two letter country code.\"\n}","language":"json"}]},"settings":"","auth":"required","params":[{"_id":"56cf1ed65267d70b00494c04","ref":"","in":"body","required":true,"desc":"Name of the project. Must be at least one character long.","default":"","type":"string","name":"name"},{"_id":"58ee7efdb4f0dd390087363f","ref":"","in":"body","required":false,"desc":"Project code.","default":"null","type":"string","name":"custom_id"},{"_id":"58ee7efdb4f0dd390087363e","ref":"","in":"body","required":false,"desc":"Project type with possible values of `general`, `manufacturing`, `power`, `water-sewer-waste`, `industrial-petroleum`, `transportation`, `hazardous-waste`, `telecom`, `education-k-12`, `education-higher`, `gov-federal`, `gov-state-local`, or `other`.","default":"null","type":"string","name":"type"},{"_id":"58ee7efdb4f0dd390087363d","ref":"","in":"body","required":false,"desc":"Project status.","default":"null","type":"string","name":"status"},{"_id":"58ee7efdb4f0dd390087363c","ref":"","in":"body","required":false,"desc":"Project owner.","default":"null","type":"string","name":"owner"},{"_id":"58ee7efdb4f0dd390087363b","ref":"","in":"body","required":false,"desc":"Project start date. See [Timestamps and Timezones](doc:timestamps-and-timezones) for accepted date formats.","default":"null","type":"string","name":"start_date"},{"_id":"58ee7efdb4f0dd390087363a","ref":"","in":"body","required":false,"desc":"Project end date. See [Timestamps and Timezones](doc:timestamps-and-timezones) for accepted date formats.","default":"null","type":"string","name":"end_date"},{"_id":"58ee7efdb4f0dd3900873639","ref":"","in":"body","required":false,"desc":"Project address, street line 1.","default":"null","type":"string","name":"street_1"},{"_id":"58ee7efdb4f0dd3900873638","ref":"","in":"body","required":false,"desc":"Project address, street line 2.","default":"null","type":"string","name":"street_2"},{"_id":"58ee7efdb4f0dd3900873637","ref":"","in":"body","required":false,"desc":"Project address town or city.","default":"null","type":"string","name":"city"},{"_id":"58ee7efdb4f0dd3900873636","ref":"","in":"body","required":false,"desc":"Project address state, province, or region.","default":"null","type":"string","name":"region"},{"_id":"58ee7efdb4f0dd3900873635","ref":"","in":"body","required":false,"desc":"Project address zip or postal code.","default":"null","type":"string","name":"postal_code"},{"_id":"58ee7efdb4f0dd3900873634","ref":"","in":"body","required":false,"desc":"Project address country in 2-letter ISO 3166 code.","default":"null","type":"string","name":"country"}],"url":"/projects"},"isReference":false,"order":30,"body":"","excerpt":"Create a new PlanGrid project. The PlanGrid account associated with the API key is added as an admin to the project team.","slug":"create-project","type":"post","title":"Create Project","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a2589","category":"59c4267167a94900103a2566","project":"55d2023b3c74062300aee506","user":"55d201fe945e481700afbb19","parentDoc":null,"version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-03-19T19:42:29.403Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"method":"get","results":{"codes":[{"status":200,"name":"Success","code":"{\n  \"data\": [\n    {\n      \"uid\": \"bafce976-8f33-437f-9c52-fb274456940f\",\n      \"name\": \"LA Natural History Museum\",\n      \"custom_id\": \"5678\",\n      \"type\": \"general\",\n      \"status\": \"completed\",\n      \"owner\": \"ACME\",\n      \"start_date\": \"2001-10-01\",\n      \"end_date\": \"2050-10-01\",\n      \"street_1\": \"900 Exposition Blvd\",\n      \"street_2\": null,\n      \"city\": \"Los Angeles\",\n      \"region\": \"California\",\n      \"postal_code\": \"90007\",\n      \"country\": \"US\"\n    },\n    {\n      \"uid\": \"327e8c64-a70d-433c-b4ac-d077415a5547\",\n      \"name\": \"3265 17th Street\",\n      \"custom_id\": \"1234\",\n      \"type\": \"general\",\n      \"status\": \"bidding\",\n      \"owner\": \"ACME\",\n      \"start_date\": \"2001-10-01\",\n      \"end_date\": \"2050-10-01\",\n      \"street_1\": \"3265 17th Street\",\n      \"street_2\": \"#404\",\n      \"city\": \"New York\",\n      \"region\": \"New York\",\n      \"postal_code\": \"10118\",\n      \"country\": \"US\"\n    }\n  ],\n  \"total_count\": 100,\n  \"next_page_url\": \"https://io.plangrid.com/projects?skip=2&limit=2\"\n}\n","language":"json"}]},"settings":"","auth":"required","params":[{"_id":"56cf1ed65267d70b00494c03","ref":"","in":"query","required":false,"desc":"Number of projects to retrieve. Maximum value of 50.","default":"50","type":"int","name":"limit"},{"_id":"56cf1ed65267d70b00494c02","ref":"","in":"query","required":false,"desc":"Number of projects to skip in the set of results.","default":"0","type":"int","name":"skip"},{"_id":"56edae5ffc1410200082dc60","ref":"","in":"query","required":false,"desc":"Only retrieve projects created/updated after specified UTC date and time (does not count changes in records contained in project). See [Timestamps and Timezones](doc:timestamps-and-timezones) for accepted date formats.","default":"","type":"datetime","name":"updated_after"}],"url":"/projects"},"isReference":false,"order":31,"body":"","excerpt":"Get a list of projects where the PlanGrid account is a team member. Results are paginated, see [Pagination](doc:pagination) for details on how pagination works in PlanGrid's API.","slug":"list-all-projects","type":"get","title":"List All Projects","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a258a","category":"59c4267167a94900103a2566","project":"55d2023b3c74062300aee506","parentDoc":null,"user":"55d201fe945e481700afbb19","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-03-19T19:56:25.570Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"method":"get","results":{"codes":[{"language":"json","status":200,"name":"Success","code":"{\n  \"uid\": \"bafce976-8f33-437f-9c52-fb274456940f\",\n  \"name\": \"LA Natural History Museum\",\n  \"custom_id\": \"5678\",\n  \"type\": \"general\",\n  \"status\": \"completed\",\n  \"owner\": \"ACME\",\n  \"start_date\": \"2001-10-01\",\n  \"end_date\": \"2050-10-01\",\n  \"street_1\": \"900 Exposition Blvd\",\n  \"street_2\": null,\n  \"city\": \"Los Angeles\",\n  \"region\": \"California\",\n  \"postal_code\": \"90007\",\n  \"country\": \"US\"\n}\n"},{"code":"{\n  \"message\": \"Project (bafce976-8f33-437f-9c58-fb274456940f) does not exist.\"\n}\n","language":"json","status":404,"name":"Project Missing"},{"status":403,"name":"No Access","code":"{\n  \"message\": \"Access to project (bafce976-8f33-437f-9c58-fb274456940f) prohibited.\"\n}\n","language":"json"}]},"settings":"","auth":"required","params":[{"_id":"56cf1ed55267d70b00494c01","ref":"","in":"path","required":true,"desc":"Unique identifier of project to retrieve.","default":"","type":"string","name":"project_uid"}],"url":"/projects/:project_uid"},"isReference":false,"order":32,"body":"","excerpt":"Get a specific project by unique identifier.","slug":"retrieve-a-project","type":"get","title":"Retrieve a Project","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a258b","category":"59c4267167a94900103a2566","parentDoc":null,"project":"55d2023b3c74062300aee506","user":"55d201fe945e481700afbb19","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-03-19T19:38:02.478Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","examples":{"codes":[]},"method":"patch","results":{"codes":[{"name":"","code":"{\n  \"uid\": \"bafce976-8f33-437f-9c52-fb274456940f\",\n  \"name\": \"My New New Construction Project.\",\n  \"custom_id\": \"1234\",\n  \"type\": \"general\",\n  \"status\": \"bidding\",\n  \"owner\": \"ACME\",\n  \"start_date\": \"2001-10-01\",\n  \"end_date\": \"2050-10-01\",\n  \"street_1\": \"350 5th Avenue\",\n  \"street_2\": null,\n  \"city\": \"New York\",\n  \"region\": \"New York\",\n  \"postal_code\": \"10118\",\n  \"country\": \"US\"\n}","language":"json","status":200},{"name":"Invalid Name","code":"{\n  \"message\": \"Name (0) must be a string at least one character long.\"\n}","language":"json","status":400},{"status":400,"name":"Invalid Custom ID","code":"{\n  \"message\": \"Custom ID must be null or a string at least one character long.\"\n}","language":"json"},{"language":"json","code":"{\n  \"message\": \"Type (2) must be a valid project type.\"\n}","name":"Invalid Type","status":400},{"status":400,"language":"json","code":"{\n  \"message\": \"Status must be null or a string at least one character long.\"\n}","name":"Invalid Status"},{"code":"{\n  \"message\": \"Owner must be null or a string at least one character long.\"\n}","status":400,"name":"Invalid Owner","language":"json"},{"status":400,"name":"Invalid Start Date","language":"json","code":"{\n  \"message\": \"Start date (1234) must be null or a date string in ISO-8601 format (YYYY-MM-DD).\"\n}"},{"status":400,"name":"Invalid End Date","language":"json","code":"{\n  \"message\": \"End date (1234) must be null or a date string in ISO-8601 format (YYYY-MM-DD).\"\n}"},{"code":"{\n  \"message\": \"Street 1 must be null or a string at least one character long.\"\n}","language":"json","name":"Invalid Street 1","status":400},{"name":"Invalid Street 2","status":400,"code":"{\n  \"message\": \"Street 2 must be null or a string at least one character long.\"\n}","language":"json"},{"code":"{\n  \"message\": \"City must be null or a string at least one character long.\"\n}","language":"json","name":"Invalid City","status":400},{"code":"{\n  \"message\": \"Region must be null or a string at least one character long.\"\n}","language":"json","name":"Invalid Region","status":400},{"code":"{\n  \"message\": \"Postal code must be null or a string at least one character long.\"\n}","language":"json","name":"Invalid Postal Code","status":400},{"status":400,"name":"Invalid Country","language":"json","code":"{\n  \"message\": \"Country must be an ISO 3166 two letter country code.\"\n}"},{"code":"{\n  \"message\": \"Insufficient permissions to update project fields (bafce976-8f33-437f-9c58-fb274456940f).\"\n}","name":"Insufficient Permissions","status":403,"language":"json"}]},"auth":"required","params":[{"_id":"56edab5fc3628a170081effb","ref":"","in":"path","required":false,"desc":"Unique identifier of the project.","default":"","type":"string","name":"project_uid"},{"_id":"56edaad7fc1410200082dc5e","ref":"","in":"body","required":false,"desc":"New name of the project. Must be at least one character long.","default":"","type":"string","name":"name"},{"_id":"58ee7cb5bbf1611b00d95c38","ref":"","in":"body","required":false,"desc":"Project code.","default":"","type":"string","name":"custom_id"},{"_id":"58ee7cb5bbf1611b00d95c37","ref":"","in":"body","required":false,"desc":"Project type with possible values of `general`, `manufacturing`, `power`, `water-sewer-waste`, `industrial-petroleum`, `transportation`, `hazardous-waste`, `telecom`, `education-k-12`, `education-higher`, `gov-federal`, `gov-state-local`, or `other`.","default":"","type":"string","name":"type"},{"_id":"58ee7cb5bbf1611b00d95c36","ref":"","in":"body","required":false,"desc":"Project status.","default":"","type":"string","name":"status"},{"_id":"58ee7cb5bbf1611b00d95c35","ref":"","in":"body","required":false,"desc":"Project owner.","default":"","type":"string","name":"owner"},{"_id":"58ee7cb5bbf1611b00d95c34","ref":"","in":"body","required":false,"desc":"Project start date. See [Timestamps and Timezones](doc:timestamps-and-timezones) for accepted date formats.","default":"","type":"string","name":"start_date"},{"_id":"58ee7cb5bbf1611b00d95c33","ref":"","in":"body","required":false,"desc":"Project end date. See [Timestamps and Timezones](doc:timestamps-and-timezones) for accepted date formats.","default":"","type":"string","name":"end_date"},{"_id":"58ee7cb5bbf1611b00d95c32","ref":"","in":"body","required":false,"desc":"Project address, street line 1","default":"","type":"string","name":"street_1"},{"_id":"58ee7cb5bbf1611b00d95c31","ref":"","in":"body","required":false,"desc":"Project address, street line 2","default":"","type":"string","name":"street_2"},{"_id":"58ee7cb5bbf1611b00d95c30","ref":"","in":"body","required":false,"desc":"Project address town or city.","default":"","type":"string","name":"city"},{"_id":"58ee7cb5bbf1611b00d95c2f","ref":"","in":"body","required":false,"desc":"Project address state, province, or region.","default":"","type":"string","name":"region"},{"_id":"58ee7cb5bbf1611b00d95c2e","ref":"","in":"body","required":false,"desc":"Project address zip or postal code.","default":"","type":"string","name":"postal_code"},{"_id":"58ee7cb5bbf1611b00d95c2d","ref":"","in":"body","required":false,"desc":"Project address country in 2-letter ISO 3166 code.","default":"","type":"string","name":"country"}],"url":"/projects/:project_uid"},"isReference":false,"order":33,"body":"","excerpt":"Update a PlanGrid project","slug":"update-project","type":"patch","title":"Update Project","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a258c","category":"59c4267167a94900103a2567","parentDoc":null,"project":"55d2023b3c74062300aee506","user":"57db49de0678030e008a76f8","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-01-12T19:19:52.839Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"language":"json","code":"{}","name":"","status":400}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":34,"body":"[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Attribute\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"**uid**\\n`string`\",\n    \"0-1\": \"Unique identifier of the annotation. Never blank. See [Unique Identifiers](doc:unique-identifiers) for details.\",\n    \"1-0\": \"**color**\\n`string`\",\n    \"1-1\": \"Color of the annotation in [hexadecimal format](https://en.wikipedia.org/wiki/Web_colors#Hex_triplet).\",\n    \"2-0\": \"**stamp**\\n`string`\",\n    \"2-1\": \"One to two character stamp associated with the issue annotation. Usually indicates type of issue or trade associated with issue. May be `null` if the annotation is not associated with an issue.\",\n    \"3-0\": \"**visibility**\\n`string`\",\n    \"3-1\": \"Visibility level of annotation. Can be either `user` or `master`. `User` indicates a team member (or former team member) has not published the annotation to the project. Never blank.\",\n    \"4-0\": \"**deleted**\\n`boolean`\",\n    \"4-1\": \"Whether the annotation has been deleted. Never blank.\",\n    \"5-0\": \"**sheet**\\n`object`\",\n    \"5-1\": \"Reference to sheet the annotation is located on. See [Foreign Keys](doc:foreign-keys) for attribute details.\"\n  },\n  \"cols\": 2,\n  \"rows\": 6\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"uid\\\": \\\"6994b73b-c3b4-4aa3-a985-fd973e599526\\\",\\n    \\\"color\\\": \\\"#F38109\\\",\\n    \\\"stamp\\\": \\\"CN\\\",\\n    \\\"visibility\\\": \\\"master\\\",\\n    \\\"deleted\\\": false,\\n    \\\"sheet\\\": {\\n      \\\"uid\\\": \\\"f3718ded-9919-4667-a746-969fda1cfe26\\\",\\n      \\\"url\\\": \\\"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/sheets/f3718ded-9919-4667-a746-969fda1cfe26\\\"\\n    }\\n}\",\n      \"language\": \"json\"\n    }\n  ],\n  \"sidebar\": true\n}\n[/block]","excerpt":"","slug":"the-annotation-object","type":"basic","title":"The Annotation Object","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a258d","category":"59c4267167a94900103a2567","parentDoc":null,"project":"55d2023b3c74062300aee506","user":"57db49de0678030e008a76f8","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-01-12T19:21:28.127Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"method":"get","results":{"codes":[{"status":200,"language":"json","code":"{\n    \"data\": [\n        {\n            \"stamp\": \"AC\",\n            \"deleted\": false,\n            \"visibility\": \"user\",\n            \"sheet\": {\n                \"url\": \"https://io.plangrid.com/projects/0d0f2b52-17e4-4a38-8cc4-eb22997e8a36/sheets/7a98fe15-1920-4848-b423-70185411bab8\",\n                \"uid\": \"7a98fe15-1920-4848-b423-70185411bab8\"\n            },\n            \"uid\": \"236d134e-6a47-15c0-6649-b911c4f625d0\",\n            \"color\": \"#FF0000\"\n        },\n        {\n            \"stamp\": null,\n            \"deleted\": false,\n            \"visibility\": \"user\",\n            \"sheet\": {\n                \"url\": \"https://io.plangrid.com/projects/0d0f2b52-17e4-4a38-8cc4-eb22997e8a36/sheets/7a98fe15-1920-4848-b423-70185411bab8\",\n                \"uid\": \"7a98fe15-1920-4848-b423-70185411bab8\"\n            },\n            \"uid\": \"5f9bec11-3ae9-d629-3afc-80176bfb7d33\",\n            \"color\": \"#FF0000\"\n        },\n        {\n            \"stamp\": null,\n            \"deleted\": false,\n            \"visibility\": \"user\",\n            \"sheet\": {\n                \"url\": \"https://io.plangrid.com/projects/0d0f2b52-17e4-4a38-8cc4-eb22997e8a36/sheets/7a98fe15-1920-4848-b423-70185411bab8\",\n                \"uid\": \"7a98fe15-1920-4848-b423-70185411bab8\"\n            },\n            \"uid\": \"c2d2c99b-77dc-f26b-5706-4b9dfdc0d82f\",\n            \"color\": \"#FF0000\"\n        }\n    ],\n    \"total_count\": 50,\n    \"next_page_url\": \"https://io.plangrid.com/projects/0d0f2b52-17e4-4a38-8cc4-eb22997e8a36/annotations?limit=50&skip=50\"\n}","name":""},{"language":"json","status":404,"code":"{ \"message\": \"Project (0d0f2b52-17e4-4a38-8cc4-eb22997e8a36) does not exist.\" }"},{"code":"{ \"message\": \"Project (0d0f2b52-17e4-4a38-8cc4-eb22997e8a36) does not exist.\" }","language":"json","status":403}]},"settings":"","auth":"required","params":[{"_id":"5877d77eb8e8fb1900608fd1","ref":"","in":"path","required":true,"desc":"Unique identifier of project.","default":"","type":"string","name":"project_uid"},{"_id":"5877d8c0204d5439009d9fdc","ref":"","in":"query","required":false,"desc":"Number of annotations to retrieve. Maximum value of 50.","default":"50","type":"int","name":"limit"},{"_id":"5877d8c0204d5439009d9fdb","ref":"","in":"query","required":false,"desc":"Number of annotations to skip in the set of results.","default":"0","type":"int","name":"skip"},{"_id":"5877d8c0204d5439009d9fda","ref":"","in":"query","required":false,"desc":"Only retrieve annotations created/updated after specified UTC date and time. See [Timestamps and Timezones](doc:timestamps-and-timezones) for accepted date formats.","default":"","type":"datetime","name":"updated_after"}],"url":"/projects/:project_uid/annotations"},"isReference":false,"order":35,"body":"","excerpt":"Get a list of all annotations in a project. _All annotations_ inside a project are returned, including deleted, personal, and published annotations. Annotations are sorted by created at, most recent first. Results are paginated, see [Pagination](doc:pagination) for details on how pagination works in PlanGrid's API.","slug":"retrieve-annotations-in-a-project","type":"get","title":"Retrieve Annotations in a Project","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a259f","category":"59c4267167a94900103a2568","parentDoc":null,"user":"55d201fe945e481700afbb19","project":"55d2023b3c74062300aee506","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-10-23T22:54:15.916Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"language":"json","status":200,"name":"","code":"{}"},{"name":"","code":"{}","language":"json","status":400}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":36,"body":"[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"**uid**\\n`string`\",\n    \"5-0\": \"**created_by**\\n`object`\",\n    \"0-1\": \"Never blank. See [Unique Identifiers](doc:unique-identifiers) for details.\",\n    \"5-1\": \"Reference to PlanGrid user that created the attachment. In rare cases, this may not map to a real user. See [Foreign Keys](doc:foreign-keys) for attribute details.\",\n    \"h-0\": \"Attribute\",\n    \"h-1\": \"Description\",\n    \"1-0\": \"**name**\\n`string`\",\n    \"1-1\": \"-\",\n    \"4-1\": \"When the attachment was created by a client application. UTC date and time in ISO-8601 format.\",\n    \"4-0\": \"**created_at**\\n`string`\",\n    \"6-0\": \"**deleted**\\n`boolean`\",\n    \"6-1\": \"Whether the attachment has been deleted. Never blank.\",\n    \"3-0\": \"**url**\\n`string`\",\n    \"3-1\": \"URL to retrieve attachment file.\",\n    \"2-0\": \"**folder**\\n`string`\",\n    \"2-1\": \"Case-sensitive.\"\n  },\n  \"cols\": 2,\n  \"rows\": 7\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"uid\\\": \\\"78128c72-5862-458a-9577-33eaa189a5c1\\\",\\n  \\\"name\\\": \\\"Submittal.4.2.pdf\\\",\\n  \\\"folder\\\": \\\"Submittals\\\",\\n  \\\"url\\\": \\\"https://attachment-assets.plangrid.com/78128c72-5862-458a-9577-33eaa189a5c1.pdf\\\",\\n  \\\"created_at\\\": \\\"2015-10-12T16:22:54+00:00\\\",\\n  \\\"created_by\\\": {\\n    \\\"uid\\\": \\\"d3bade89-01bf-4ea0-889e-d5dad2f56e7e\\\",\\n    \\\"url\\\": \\\"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/users/d3bade89-01bf-4ea0-889e-d5dad2f56e7e\\\",\\n    \\\"email\\\": \\\"patrick.peterson@subcontractor.com\\\"    \\n  },\\n  \\\"deleted\\\": false\\n}\",\n      \"language\": \"json\"\n    }\n  ],\n  \"sidebar\": true\n}\n[/block]","excerpt":"","slug":"the-attachment-object","type":"basic","title":"The Attachment Object","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a25a0","category":"59c4267167a94900103a2568","project":"55d2023b3c74062300aee506","parentDoc":null,"user":"55fc7da63c21291900e7e0a5","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-04-13T20:42:13.382Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"auth":"required","params":[],"url":""},"isReference":false,"order":37,"body":"The following table lists the various file types supported as attachments.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Type of document\",\n    \"h-1\": \"File extension\",\n    \"0-0\": \"Image\",\n    \"0-1\": \".png\\n.jpeg\\n.jpg\\n.gif\\n.bmp\",\n    \"1-0\": \"Spreadsheet\",\n    \"1-1\": \".xlsx\\n.xls\",\n    \"2-0\": \"Open Document\",\n    \"2-1\": \".rtf\\n.doc\\n.docx\\n.txt\\n.odf\",\n    \"3-0\": \"Video\",\n    \"3-1\": \".webm\\n.mpg\\n.mov\\n.f4v\\n.avi\\n.mp4\\n.wmv\",\n    \"4-0\": \"Design\",\n    \"4-1\": \".rvt\\n.dwg\\n.dxf\\n.dgn\\n.dwf\\n.dwfx\",\n    \"5-0\": \"Google Earth\",\n    \"5-1\": \".kmz\\n.kml\"\n  },\n  \"cols\": 2,\n  \"rows\": 6\n}\n[/block]","excerpt":"","slug":"supported-file-types","type":"basic","title":"Supported File Types","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a25a1","category":"59c4267167a94900103a2568","parentDoc":null,"project":"55d2023b3c74062300aee506","user":"55d201fe945e481700afbb19","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-03-19T20:45:43.733Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"method":"post","results":{"codes":[{"status":201,"language":"json","code":"{\n  \"uid\": \"022c132d-cdd0-48a1-8874-d4c9fd310ec8\",\n  \"webhook_url\": \"https://io.plangrid.com/projects/4d0f4ff6-b4e7-fb41-edb2-139b0fff9ef7/attachments/uploads/completions/8392cd3fbf2dfbf9fc539c8423a21201\",\n  \"aws_post_form_arguments\": {\n    \"action\": \"https://attachments.s3.amazonaws.com/\",\n    \"fields\": [\n      {\n        \"name\": \"key\",\n        \"value\": \"4d0f4ff6-b4e7-fb41-edb2-139b0fff9ef7\\/1ab29ace-adfe-4ff0-b4bd-267ca612df9a_ff\"\n      },\n      {\n        \"name\": \"AWSAccessKeyId\",\n        \"value\": \"AKIAIWKPH7OCNIEE5GGQ\"\n      },\n      {\n        \"name\": \"success_action_redirect\",\n        \"value\": \"https:\\/\\/plangrid-c-api-dispatcher-test.herokuapp.com\\/projects\\/4d0f4ff6-b4e7-fb41-edb2-139b0fff9ef7\\/attachments\\/uploads\\/completions\\/1039b3921a93c7e74bdb3352779c2c6e\"\n      },\n      {\n        \"name\": \"policy\",\n        \"value\": \"eyJleHBpcmF0aW9uIjogIjIwMTUtMTItMjJUMjE6MTU6MTlaIiwKImNvbmRpdGlvbnMiOiBbeyJDb250ZW50LVR5cGUiOiAiYXBwbGljYXRpb24vcGRmIn0seyJidWNrZXQiOiAibG91cGUtdGVzdC1hdHRhY2gifSx7ImtleSI6ICI0ZDBmNGZmNi1iNGU3LWZiNDEtZWRiMi0xMzliMGZmZjllZjcvMWFiMjlhY2UtYWRmZS00ZmYwLWI0YmQtMjY3Y2E2MTJkZjlhX2ZmIn0seyJzdWNjZXNzX2FjdGlvbl9yZWRpcmVjdCI6ICJodHRwczovL3BsYW5ncmlkLWMtYXBpLWRpc3BhdGNoZXItdGVzdC5oZXJva3VhcHAuY29tL3YxL3Byb2plY3RzLzRkMGY0ZmY2LWI0ZTctZmI0MS1lZGIyLTEzOWIwZmZmOWVmNy9hdHRhY2htZW50cy91cGxvYWRzL2NvbXBsZXRpb25zLzEwMzliMzkyMWE5M2M3ZTc0YmRiMzM1Mjc3OWMyYzZlIn0seyJ4LWFtei1zdG9yYWdlLWNsYXNzIjogIlNUQU5EQVJEIn0seyJ4LWFtei1zZXJ2ZXItc2lkZS1lbmNyeXB0aW9uIjogIkFFUzI1NiJ9XX0=\"\n      },\n      {\n        \"name\": \"signature\",\n        \"value\": \"CztWq\\/9IU4hCaEiaw0P5IRYmh0g=\"\n      },\n      {\n        \"name\": \"Content-Type\",\n        \"value\": \"application\\/pdf\"\n      },\n      {\n        \"name\": \"x-amz-storage-class\",\n        \"value\": \"STANDARD\"\n      },\n      {\n        \"name\": \"x-amz-server-side-encryption\",\n        \"value\": \"AES256\"\n      }\n    ]\n  }\n}\n","name":"Success"},{"name":"Unsupported Content Type","status":400,"language":"json","code":"{\n  \"message\": \"Content type (application/msword) is not supported.\"\n}\n"},{"code":"{\n  \"message\": \"Content type (application/msword) is not supported.\"\n}\n","name":"Content Type Missing","status":400,"language":"json"},{"language":"json","code":"{\n  \"message\": \"Name (null) must be a string at least one character long.\"\n}\n","name":"Invalid Name","status":400},{"code":"{\n  \"message\": \"Folder (2) must be null or a string at least one character long.\"\n}\n","name":"Invalid Folder","status":400,"language":"json"},{"language":"json","code":"{\n  \"message\": \"Insufficient permissions to upload attachments to project (bafce976-8f33-437f-9c58-fb274456940f).\"\n}\n","name":"Insufficient Permissions","status":403},{"code":"{\n  \"message\": \"Access to project (bafce976-8f33-437f-9c58-fb274456940f) prohibited.\"\n}\n","name":"No Access","status":403,"language":"json"}]},"settings":"","auth":"required","params":[{"_id":"56cf1ec95267d70b00494b97","ref":"","in":"path","required":true,"desc":"Unique identifier of project.","default":"","type":"string","name":"project_uid"},{"_id":"56cf1ec95267d70b00494b96","ref":"","in":"body","required":true,"desc":"Content type of the attachment's file.","default":"","type":"string","name":"content_type"},{"_id":"56cf1ec95267d70b00494b95","ref":"","in":"body","required":true,"desc":"Name of the attachment.","default":"","type":"string","name":"name"},{"_id":"56cf1ec95267d70b00494b94","ref":"","in":"body","required":false,"desc":"Folder in project to place the attachment in (case-sensitive).","default":"","type":"string","name":"folder"}],"url":"/projects/:project_uid/attachments/uploads"},"isReference":false,"order":38,"body":"","excerpt":"First of three step process for uploading an attachment to a project. On success, necessary information for step two and three is returned. The attachment record is not created until all three steps are completed. See [File Uploads](doc:file-uploads) for details.","slug":"upload-attachment-to-project","type":"post","title":"Upload Attachment to Project","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a25a2","category":"59c4267167a94900103a2568","parentDoc":null,"project":"55d2023b3c74062300aee506","user":"55d201fe945e481700afbb19","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-03-19T21:01:57.154Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"method":"get","results":{"codes":[{"language":"json","code":"{\n  \"uid\": \"147a420e-a182-4312-8fa5-4d10064d2f1a\",\n  \"name\": \"Bender\",\n  \"folder\": \"Specifications\",\n  \"url\": \"https://attachment-assets.plangrid.com/147a420e-a182-4312-8fa5-4d10064d2f1a.pdf\",\n  \"created_at\": \"2013-05-17T02:30:22+00:00\",\n  \"created_by\": {\n    \"uid\": null,\n    \"url\": null,\n    \"email\": \"nick@subcontractor.com\"\n  },\n  \"deleted\": false\n}\n","name":"Success","status":201},{"language":"json","code":"{\n  \"message\": \"File associated with upload token (8392cd3fbf2dfbf9fc539c8423a21201) is missing.\"\n}\n","name":"File Missing","status":400},{"language":"json","code":"{\n  \"message\": \"Attachment for upload token (8392cd3fbf2dfbf9fc539c8423a21201) does not exist\"\n}\n","name":"Upload Token Missing","status":404},{"language":"json","code":"{\n  \"message\": \"Upload token (8392cd3fbf2dfbf9fc539c8423a21201) expired.\"\n}","name":"Upload Token Expired","status":410},{"language":"json","code":"{\n  \"message\": \"Sorry, PlanGrid was unable to complete the upload. Use the url included with this message to try again.\"\n  \"url\": \"https://io.plangrid.com/v1/projects/4d0f4ff6-b4e7-fb41-edb2-139b0fff9ef7/attachments/uploads/completions/8392cd3fbf2dfbf9fc539c8423a21201\"\n}\n","name":"Server Error","status":500},{"status":409,"code":"{\n  \"message\": \"Upload token (8392cd3fbf2dfbf9fc539c8423a21201) consumed.\"\n}","language":"json"}]},"settings":"","auth":"required","params":[{"_id":"56cf1ec85267d70b00494b8d","ref":"","in":"path","required":true,"desc":"Unique identifier of project.","default":"","type":"string","name":"project_uid"},{"_id":"56cf1ec85267d70b00494b8c","ref":"","in":"path","required":true,"desc":"Token that uniquely identifies the upload.","default":"","type":"string","name":"upload_token"}],"url":"/projects/:project_uid/attachments/uploads/completions/:upload_token"},"isReference":false,"order":39,"body":"","excerpt":"Last of three step process for uploading an attachment to a project. On success, the new attachment record is created and returned. This step is handled automatically with appropriate configuration. See [File Uploads](doc:file-uploads) for details.","slug":"complete-attachment-upload-to-project","type":"get","title":"Complete Attachment Upload to Project","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a25a3","category":"59c4267167a94900103a2568","parentDoc":null,"user":"55d201fe945e481700afbb19","project":"55d2023b3c74062300aee506","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-03-19T20:43:49.034Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"method":"get","results":{"codes":[{"name":"Success","code":"{\n  \"data\": [\n    {\n      \"uid\": \"147a420e-a182-4312-8fa5-4d10064d2f1a\",\n      \"name\": \"Bender\",\n      \"folder\": \"Specifications\",\n      \"url\": \"https://attachment-assets.plangrid.com/147a420e-a182-4312-8fa5-4d10064d2f1a.pdf\",\n      \"created_at\": \"2013-05-17T02:30:22+00:00\",\n      \"created_by\": {\n        \"uid\": null,\n        \"url\": null,\n        \"email\": \"nick@subcontractor.com\"\n      },\n      \"deleted\": false\n    },\n    {\n      \"uid\": \"40f38b8b-019e-44d8-8cb8-86454c327fb5\",\n      \"name\": \"Cement\",\n      \"folder\": \"Submittals\",\n      \"url\": \"https://attachment-assets.plangrid.com/40f38b8b-019e-44d8-8cb8-86454c327fb5.pdf\",\n      \"created_at\": \"2013-05-13T04:30:22+00:00\",\n      \"created_by\": {\n        \"uid\": \"80efb7e6-f15c-479a-8429-7e153b1e2a52\",\n        \"url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/users/80efb7e6-f15c-479a-8429-7e153b1e2a52\",\n        \"email\": \"betty@construction.com\"\n      },\n      \"deleted\": true\n    }\n  ],\n  \"total_count\": 14,\n  \"next_page_url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/attachments?skip=2&limit=2\"\n}\n","language":"json","status":200},{"status":404,"name":"Project Missing","code":"{\n  \"message\": \"Project (bafce976-8f33-437f-9c58-fb274456940f) does not exist.\"\n}\n","language":"json"},{"name":"No Project Access","code":"{\n  \"message\": \"Access to project (bafce976-8f33-437f-9c58-fb274456940f) prohibited.\"\n}\n","language":"json","status":403}]},"settings":"","auth":"required","params":[{"_id":"56cf1ec95267d70b00494b93","ref":"","in":"path","required":true,"desc":"Unique identifier of project.","default":"","type":"string","name":"project_uid"},{"_id":"56cf1ec95267d70b00494b92","ref":"","in":"query","required":false,"desc":"Folder to filter results by (case-sensitive). Empty string retrieves all attachments where folder is `null` or `\"\"`.","default":"","type":"string","name":"folder"},{"_id":"56cf1ec95267d70b00494b91","ref":"","in":"query","required":false,"desc":"Number of attachments to retrieve. Maximum value of 50.","default":"50","type":"int","name":"limit"},{"_id":"56cf1ec95267d70b00494b90","ref":"","in":"query","required":false,"desc":"Number of attachments to skip in the set of results.","default":"0","type":"int","name":"skip"},{"_id":"56edba05949cc2320083727b","ref":"","in":"query","required":false,"desc":"Only retrieve attachments created/updated after specified UTC date and time. See [Timestamps and Timezones](doc:timestamps-and-timezones) for accepted date formats.","default":"","type":"datetime","name":"updated_after"}],"url":"/projects/:project_uid/attachments"},"isReference":false,"order":40,"body":"","excerpt":"Get a list of attachments in a project optionally filtered by folder. Results return deleted attachments and are paginated, see [Pagination](doc:pagination) for details on how pagination works in PlanGrid's API.","slug":"retrieve-attachments-in-a-project","type":"get","title":"Retrieve Attachments in a Project","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a25a4","category":"59c4267167a94900103a2568","project":"55d2023b3c74062300aee506","user":"55d201fe945e481700afbb19","parentDoc":null,"version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-03-19T20:44:42.129Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"method":"get","results":{"codes":[{"code":"{\n  \"uid\": \"147a420e-a182-4312-8fa5-4d10064d2f1a\",\n  \"name\": \"Bender\",\n  \"folder\": \"Specifications\",\n  \"url\": \"https://attachment-assets.plangrid.com/147a420e-a182-4312-8fa5-4d10064d2f1a.pdf\",\n  \"created_at\": \"2013-05-17T02:30:22+00:00\",\n  \"created_by\": {\n    \"uid\": null,\n    \"url\": null,\n    \"email\": \"nick@subcontractor.com\"\n  },\n  \"deleted\": false\n}\n","language":"json","status":200,"name":"Success"},{"status":404,"name":"Project Missing","code":"{\n  \"message\": \"Project (bafce976-8f33-437f-9c58-fb274456940f) does not exist.\"\n}\n","language":"json"},{"status":404,"name":"Attachment Missing","code":"{\n  \"message\": \"Attachment (147a420e-a182-4312-8fa5-4d10064d2f1a) does not exist on project (bafce976-8f33-437f-9c58-fb274456940f).\"\n}\n","language":"json"},{"status":403,"name":"No Project Access","code":"{\n  \"message\": \"Access to project (bafce976-8f33-437f-9c58-fb274456940f) prohibited.\"\n}\n","language":"json"}]},"settings":"","auth":"required","params":[{"_id":"56cf1ec85267d70b00494b8f","ref":"","in":"path","required":true,"desc":"Unique identifier of project.","default":"","type":"string","name":"project_uid"},{"_id":"56cf1ec85267d70b00494b8e","ref":"","in":"path","required":true,"desc":"Unique identifier of attachment.","default":"","type":"string","name":"attachment_uid"}],"url":"/projects/:project_uid/attachments/:attachment_uid"},"isReference":false,"order":41,"body":"","excerpt":"Get an attachment in a project.","slug":"retrieve-attachment-in-a-project","type":"get","title":"Retrieve Attachment in a Project","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a25a5","category":"59c4267167a94900103a2568","project":"55d2023b3c74062300aee506","user":"55d201fe945e481700afbb19","parentDoc":null,"version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-03-20T22:42:40.912Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"name":"Success","code":"{\n  \"uid\": \"147a420e-a182-4312-8fa5-4d10064d2f1a\",\n  \"name\": \"Bender\",\n  \"folder\": \"Specifications\",\n  \"url\": \"https://attachment-assets.plangrid.com/147a420e-a182-4312-8fa5-4d10064d2f1a.pdf\",\n  \"created_at\": \"2013-05-17T02:30:22+00:00\",\n  \"created_by\": {\n    \"uid\": null,\n    \"url\": null,\n    \"email\": \"nick@subcontractor.com\"\n  },\n  \"deleted\": false\n}\n","language":"json"},{"language":"json","status":400,"name":"Invalid Name","code":"{\n  \"message\": \"Name (null) must be a string at least one character long.\"\n}"},{"status":400,"name":"Invalid Folder","code":"{\n  \"message\": \"Folder (2) must be null or a string at least one character long.\"\n}","language":"json"},{"code":"{\n  \"message\": \"Insufficient permissions to update attachment (147a420e-a182-4312-8fa5-4d10064d2f1a) in project (bafce976-8f33-437f-9c58-fb274456940f).\"\n}","language":"json","status":403,"name":"Insufficient Permissions"},{"name":"No Access","code":"{\n  \"message\": \"Access to project (bafce976-8f33-437f-9c58-fb274456940f) prohibited.\"\n}","language":"json","status":403},{"code":"{\n  \"message\": \"Attachment (baa813cf-fd44-4a9c-be2b-62669958cc9a) is deleted and cannot be updated.\"\n}","language":"json","status":400},{"code":"{\n  \"message\": \"Attachment (147a420e-a182-4312-8fa5-4d10064d2f1a) was not found in project (bafce976-8f33-437f-9c58-fb274456940f).\"\n}","language":"json","status":404,"name":"Attachment Missing"},{"status":404,"name":"Project Missing","language":"json","code":"{\n  \"message\": \"Project (bafce976-8f33-437f-9c58-fb274456940f) does not exist.\"\n}"}]},"settings":"","examples":{"codes":[]},"method":"patch","auth":"required","params":[{"_id":"56cf1ec95267d70b00494b97","ref":"","in":"path","required":true,"desc":"Unique identifier of project.","default":"","type":"string","name":"project_uid"},{"_id":"56cf1ec95267d70b00494b96","ref":"","in":"body","required":true,"desc":"Unique identifier of attachment","default":"","type":"string","name":"attachmend_uid"},{"_id":"56cf1ec95267d70b00494b95","ref":"","in":"body","required":false,"desc":"New name of the attachment.","default":"","type":"string","name":"name"},{"_id":"56cf1ec95267d70b00494b94","ref":"","in":"body","required":false,"desc":"New folder in project to place the attachment in (case-sensitive).","default":"","type":"string","name":"folder"}],"url":"/projects/:project_uid/attachments/:attachment_uid"},"isReference":false,"order":42,"body":"","excerpt":"Update an attachment's metadata. If you want to change the attachment's file, you'll need to delete the photo and upload a new one.","slug":"update-attachment-in-a-project","type":"patch","title":"Update Attachment in a Project","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a25a6","category":"59c4267167a94900103a2568","user":"55d201fe945e481700afbb19","parentDoc":null,"project":"55d2023b3c74062300aee506","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-03-20T22:27:21.230Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"method":"delete","results":{"codes":[{"language":"json","status":204,"name":"","code":""},{"code":"{\n  \"message\": \"Project (bafce976-8f33-437f-9c58-fb274456940f) does not exist.\"\n}","language":"json","status":404,"name":"Project Missing"},{"name":"Attachment Missing","status":404,"code":"{\n  \"message\": \"Attachment (87658a3f-8ee0-4188-9c55-b06a203fa9e7) was not found in project (bafce976-8f33-437f-9c58-fb274456940f).\"\n}","language":"json"},{"language":"json","status":403,"name":"No Project Access","code":"{\n  \"message\": \"Access to project (bafce976-8f33-437f-9c58-fb274456940f) is prohibited.\"\n}"}]},"settings":"","auth":"required","params":[{"_id":"56ef222ba5bcfd0e00951766","ref":"","in":"path","required":true,"desc":"Unique identifier of project.","default":"","type":"string","name":"project_uid"},{"_id":"56ef2236aff1620e00a32356","ref":"","in":"path","required":true,"desc":"Unique identifier of attachment.","default":"","type":"string","name":"attachment_uid"}],"url":"/projects/:project_uid/attachments/:attachment_uid"},"isReference":false,"order":43,"body":"","excerpt":"Removes an attachment from a project. If attachment has already been removed, a `204` is still returned. See [Deleted Records](doc:deleted-records) for details on deleted records.","slug":"remove-attachment-from-project","type":"delete","title":"Remove Attachment from Project","__v":0,"childrenPages":[]}

{"_id":"59c4267267a94900103a25de","category":"59c4267167a94900103a2569","project":"55d2023b3c74062300aee506","parentDoc":null,"user":"55d201fe945e481700afbb19","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-08-14T21:07:05.673Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"auth":"required","params":[],"url":""},"isReference":false,"order":44,"body":"[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"**uid**\\n`string`\",\n    \"3-0\": \"**created_by**\\n`object`\",\n    \"0-1\": \"Never blank. See [Unique Identifiers](doc:unique-identifiers) for details.\",\n    \"3-1\": \"Reference to PlanGrid user that created issue. Will always map to a real user. See [Foreign Keys](doc:foreign-keys) for attribute details.\",\n    \"h-0\": \"Attribute\",\n    \"h-1\": \"Description\",\n    \"1-0\": \"**text**\\n`string`\",\n    \"1-1\": \"-\",\n    \"2-1\": \"When the comment was created by a client application. UTC date and time in ISO-8601 format.\",\n    \"2-0\": \"**created_at**\\n`string`\",\n    \"4-0\": \"**record_type**\\n`string`\",\n    \"4-1\": \"Type of record the comment is for. Possible values are `project`, `issue`, `rfi`, and `sheet`.\",\n    \"5-0\": \"**record**\\n`object`\",\n    \"5-1\": \"Reference to record comment is for. See [Foreign Keys](doc:foreign-keys) for attribute details.\"\n  },\n  \"cols\": 2,\n  \"rows\": 6\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"uid\\\": \\\"8510cfc9-2a82-4736-bf37-753c900d1c68\\\",\\n  \\\"text\\\": \\\"You looking at me?\\\",\\n  \\\"created_at\\\": \\\"2015-10-12T14:17:27+00:00\\\",\\n  \\\"created_by\\\": {\\n    \\\"uid\\\": \\\"10dd6d24-cbe2-4639-9647-f9d0cc4aaee8\\\",\\n    \\\"url\\\": \\\"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/users/10dd6d24-cbe2-4639-9647-f9d0cc4aaee8\\\",\\n    \\\"email\\\": \\\"travis@subcontractor.com\\\"    \\n  },\\n  \\\"record_type\\\": \\\"project\\\",\\n  \\\"record\\\": {\\n    \\\"uid\\\": \\\"bafce976-8f33-437f-9c52-fb274456940f\\\",\\n    \\\"url\\\": \\\"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f\\\",\\n  }\\n}\",\n      \"language\": \"json\"\n    }\n  ],\n  \"sidebar\": true\n}\n[/block]","excerpt":"","slug":"the-comment-object","type":"basic","title":"The Comment Object","__v":0,"childrenPages":[]}

{"_id":"59c4267267a94900103a25df","category":"59c4267167a94900103a2569","project":"55d2023b3c74062300aee506","parentDoc":null,"user":"55d201fe945e481700afbb19","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-08-14T21:14:42.692Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"method":"get","results":{"codes":[{"status":200,"language":"json","code":"{\n  \"data\": [\n    {\n      \"uid\": \"87658a3f-8ee0-4188-9c55-b06a203fa9e7\",\n      \"text\": \"Great Scott!\",\n      \"created_at\": \"2013-05-17t02:30:22z\",\n      \"created_by\": {\n        \"uid\": \"deae0b56-81c7-4a05-8e8b-410fd17a01f0\",\n        \"url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/users/deae0b56-81c7-4a05-8e8b-410fd17a01f0\",\n        \"email\": \"doc@subcontractor.com\"\n      },\n      \"record_type\": \"project\",\n      \"record\": {\n        \"uid\": \"bafce976-8f33-437f-9c52-fb274456940f\",\n        \"url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f\"\n      }\n    },\n    {\n      \"uid\": \"465abf98-accb-42cd-bd54-16f29e8447f2\",\n      \"text\": \"Jesus, George, it was a wonder I was even born.\",\n      \"created_at\": \"2013-05-15t18:54:22z\",\n      \"created_by\": {\n        \"uid\": \"80efb7e6-f15c-479a-8429-7e153b1e2a52\",\n        \"url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/users/80efb7e6-f15c-479a-8429-7e153b1e2a52\",\n        \"email\": \"marty@construction.com\"\n      },\n      \"record_type\": \"issue\",\n      \"record\": {\n        \"uid\": \"b9876ac1-369f-401b-8ca0-6f152b533895\",\n        \"url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/issues/b9876ac1-369f-401b-8ca0-6f152b533895\"\n      }\n    },\n    {\n      \"uid\": \"08ea8b05-a99c-40a7-a312-fee360ad432a\",\n      \"text\": \"I'm sure that in 1985, plutonium is available in every corner drugstore, but in 1955, it's a little hard to come by.\",\n      \"created_at\": \"2013-05-14t8:30:56z\",\n      \"created_by\": {\n        \"uid\": \"deae0b56-81c7-4a05-8e8b-410fd17a01f0\",\n        \"url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/users/deae0b56-81c7-4a05-8e8b-410fd17a01f0\",\n        \"email\": \"doc@subcontractor.com\"\n      },\n      \"record_type\": \"rfi\",\n      \"record\": {\n        \"uid\": \"c62d6a09-1e7c-4aa0-b60b-86249eba7e5b\",\n        \"url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/rfis/c62d6a09-1e7c-4aa0-b60b-86249eba7e5b\"\n      }\n    },\n    {\n      \"uid\": \"68839690-e0aa-4751-aedf-e630b921e91e\",\n      \"text\": \"Look, Marvin, you gotta play. See, that's where they kiss for the first time on the dance floor. And if there's no music, they can't dance. If they can't dance, they can't kiss. If they can't kiss they can't fall in love, and I'm history.\",\n      \"created_at\": \"2013-05-13t11:22:56z\",\n      \"created_by\": {\n        \"uid\": \"80efb7e6-f15c-479a-8429-7e153b1e2a52\",\n        \"url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/users/80efb7e6-f15c-479a-8429-7e153b1e2a52\",\n        \"email\": \"marty@construction.com\"\n      },\n      \"record_type\": \"rfi\",\n      \"record\": {\n        \"uid\": \"c62d6a09-1e7c-4aa0-b60b-86249eba7e5b\",\n        \"url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/rfis/c62d6a09-1e7c-4aa0-b60b-86249eba7e5b\"\n      }\n    }\n  ],\n  \"total_count\": 6,\n  \"next_page_url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/comments?skip=4&limit=4\"\n}","name":"Success"},{"status":404,"language":"json","code":"{\n  \"message\": \"Project (bafce976-8f33-437f-9c58-fb274456940f) does not exist.\"\n}","name":"Project Missing"},{"name":"Invalid Record Type","status":400,"code":"{\n  \"message\": \"Record type (1) must be a valid record type.\"\n}","language":"json"},{"code":"{\n  \"message\": \"Access to project (bafce976-8f33-437f-9c58-fb274456940f) is prohibited.\"\n}","language":"json","status":403,"name":"No Project Access"}]},"settings":"","auth":"required","params":[{"_id":"57b0e1de9ee0960e00440bbe","ref":"","in":"path","required":true,"desc":"Unique identifier of project.","default":"","type":"string","name":"project_uid"},{"_id":"57b0e1de9ee0960e00440bbd","ref":"","in":"query","required":false,"desc":"Number of comments to retrieve. Maximum value of 50.","default":"50","type":"int","name":"limit"},{"_id":"57b0e1de9ee0960e00440bbc","ref":"","in":"query","required":false,"desc":"Number of comments to skip in the set of results.","default":"0","type":"int","name":"skip"},{"_id":"57b0e1de9ee0960e00440bbb","ref":"","in":"query","required":false,"desc":"Only retrieve comments created/updated after specified UTC date and time. See [Timestamps and Timezones](doc:timestamps-and-timezones) for accepted date formats.","default":"","type":"datetime","name":"updated_after"},{"_id":"57b0e2889ee0960e00440bbf","ref":"","in":"query","required":false,"desc":"Comma separate list of record types. Possible values are `project`, `issue`, `rfi`, `sheet`. Case insensitive and removes duplicates.","default":"","type":"string","name":"record_types"}],"url":"/projects/:project_uid/comments"},"isReference":false,"order":45,"body":"","excerpt":"Get a list of comments across all records in a project (most recently created first).  Results are paginated and can optionally be filtered by record type, see [Pagination](doc:pagination) for details on how pagination works in PlanGrid's API.","slug":"retrieve-comments-in-a-project","type":"get","title":"Retrieve Comments in a Project","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a257a","category":"59c4267167a94900103a256a","parentDoc":null,"project":"55d2023b3c74062300aee506","user":"55d201fe945e481700afbb19","version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-09-28T06:57:39.713Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"name":"","code":"{}","language":"json"},{"name":"","code":"{}","language":"json","status":400}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":46,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Sheet Versions & Annotations\"\n}\n[/block]\nMultiple versions of the same sheet can exist in PlanGrid. As new versions of a sheet are uploaded, the annotations on old versions are copied to the newer version. We’ll illustrate how this is represented in PlanGrid’s data model via a simple example. Say you upload the first version of a sheet (“Version 1”); a Sheet record is created in PlanGrid with `sheet.version_name` set to “Version 1”:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/CdUUaxKQwi24DmpR6KjD_1.png\",\n        \"1.png\",\n        \"2438\",\n        \"451\",\n        \"#c7c7c7\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nSometime later you upload the second version of a sheet (“Version 2”). A second Sheet record is created in PlanGrid with `sheet.version_name` set to “Version 2”:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/QVxkrdfxQGy9ILZd7kSL_2.png\",\n        \"2.png\",\n        \"2438\",\n        \"451\",\n        \"#cdcdcd\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nYou add an annotation to the second version of the sheet. This creates an Annotation record that points to the second version Sheet record (via a foreign key for the Sheet `uid`):\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/fiqwlVJoS4iWroprHM9R_3.png\",\n        \"3.png\",\n        \"2438\",\n        \"451\",\n        \"#9c9c9c\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nWhen you upload the third version of a sheet (“Version 3”), the annotation is copied from “Version 2”. In our data model, a new Sheet record is created (with `sheet.version_name` set to “Version 3”), the Annotation record is copied, and the copy points to the third version Sheet Record:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/EbQKdX80SkC6REHl0Nrq_4.png\",\n        \"4.png\",\n        \"2438\",\n        \"451\",\n        \"#9e9e9e\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Issues and Annotations\"\n}\n[/block]\nWhen an issue is placed on a sheet, the PlanGrid data model creates an Issue record *and* an Annotation record. The annotation stores information on where and how to display the issue on the sheet. As new versions of a sheet are uploaded, multiple annotations are created:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/YVK4B3p1TIqcHDNkvp4F_5.png\",\n        \"5.png\",\n        \"1313\",\n        \"392\",\n        \"#c7c7c7\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nAs a convenience, we include the most current annotation on any issue record returned through the PlanGrid API.","excerpt":"","slug":"sheet-versions-annotations","type":"basic","title":"Background","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a257b","category":"59c4267167a94900103a256a","project":"55d2023b3c74062300aee506","user":"55d201fe945e481700afbb19","parentDoc":null,"version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-09-27T22:03:27.758Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"name":"","code":"{}","language":"json"},{"language":"json","status":400,"name":"","code":"{}"}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":47,"body":"[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"**uid**\\n`string`\",\n    \"0-1\": \"Never blank. See [Unique Identifiers](doc:unique-identifiers) for details.\",\n    \"1-0\": \"**number**\\n`integer`\",\n    \"2-0\": \"**current_annotation**\\n`object`\",\n    \"3-0\": \"**current_annotation.uid**\\n`string`\",\n    \"4-0\": \"**current_annotation.color**\\n`string`\",\n    \"5-0\": \"**current_annotation.stamp**\\n`string`\",\n    \"6-0\": \"**current_annotation.visibility**\\n`string`\",\n    \"7-0\": \"**current_annotation.deleted**\\n`boolean`\",\n    \"8-0\": \"**current_annotation.sheet**\\n`object`\",\n    \"9-0\": \"**room**\\n`string`\",\n    \"11-0\": \"**description**\\n`string`\",\n    \"12-0\": \"**assigned_to**\\n`array`\",\n    \"13-0\": \"**status**\\n`string`\",\n    \"14-0\": \"**created_at**\\n`string`\",\n    \"15-0\": \"**created_by**\\n`object`\",\n    \"16-0\": \"**updated_at**\\n`string`\",\n    \"17-0\": \"**updated_by**\\n`object`\",\n    \"26-0\": \"**deleted**\\n`boolean`\",\n    \"1-1\": \"Issue number assigned by PlanGrid. May not be unique. Never blank.\",\n    \"2-1\": \"Associated annotation that exists on most recent version. May not be current set. In rare cases, may be blank.\",\n    \"3-1\": \"Unique identifier of the annotation. Never blank. See [Unique Identifiers](doc:unique-identifiers) for details.\",\n    \"4-1\": \"Color of the annotation in [hexadecimal format](https://en.wikipedia.org/wiki/Web_colors#Hex_triplet).\",\n    \"5-1\": \"One to two character stamp associated with issue. Usually indicates type of issue or trade associated with issue.\",\n    \"6-1\": \"Visibility level of issue. Can be either `user` or `master`. `User` indicates a team member (or former team member) has not published the issue to the project. Never blank.\",\n    \"7-1\": \"Whether the annotation has been deleted. Never blank.\",\n    \"8-1\": \"Reference to sheet the current annotation is located on. See [Foreign Keys](doc:foreign-keys) for attribute details.\",\n    \"9-1\": \"Room or location of issue. May be `null`.\",\n    \"11-1\": \"The description of the issue. May be `null`.\",\n    \"12-1\": \"An array of users that the issue is assigned to. Currently only supports one user. Does not have to be a real PlanGrid user. See [Foreign Keys](doc:foreign-keys) for attribute details.\",\n    \"13-1\": \"Current status of issue. Possible values are \\\"open\\\", \\\"in_review\\\", \\\"pending\\\", \\\"closed\\\".\",\n    \"14-1\": \"When the issue was created by a client application. UTC date and time in ISO-8601 format.\",\n    \"15-1\": \"Reference to PlanGrid user that created issue. In rare cases, this may not map to a real user. See [Foreign Keys](doc:foreign-keys) for attribute details.\",\n    \"16-1\": \"When the issue was updated by a PlanGrid client. Publishing, moving issue on sheet, modifying photos, or adding comments *will not affect* updated_at. UTC date and time in ISO-8601 format.\",\n    \"17-1\": \"Reference to PlanGrid user that last updated issue. In rare cases, this may not map to a real user. See [Foreign Keys](doc:foreign-keys) for attribute details.\",\n    \"26-1\": \"Whether the issue has been deleted. Never blank.\",\n    \"h-0\": \"Attribute\",\n    \"h-1\": \"Description\",\n    \"18-0\": \"**photos**\\n`object`\",\n    \"19-0\": \"**comments**\\n`object`\",\n    \"18-1\": \"Reference to collection of photos on issue. See [Foreign Keys](doc:foreign-keys) for attribute details.\",\n    \"19-1\": \"Reference to collection of comments on issue. See [Foreign Keys](doc:foreign-keys) for attribute details.\",\n    \"10-0\": \"**title**\\n`string`\",\n    \"10-1\": \"The title of the issue. May be `null`.\",\n    \"20-0\": \"**due_at**\\n`string`\",\n    \"20-1\": \"When the Issue is due. UTC date and time in ISO-8601 format. May be `null`.\",\n    \"21-0\": \"**has_cost_impact**\\n`boolean`\",\n    \"21-1\": \"Whether the Issue has a cost impact. Never blank.\",\n    \"22-0\": \"**cost_impact**\\n`decimal`\",\n    \"22-1\": \"What the Issue's cost impact with accuracy to hundredths of a cent. May be `null`.\",\n    \"23-0\": \"**currency_code**\\n`string`\",\n    \"23-1\": \"The ISO-4217 currency code of the `cost_impact`. Currently only supports `USD`. May be `null` if `cost_impact` is not specified.\",\n    \"24-0\": \"**has_schedule_impact**\\n`boolean`\",\n    \"24-1\": \"Whether the Issue has a schedule impact. Never blank.\",\n    \"25-0\": \"**schedule_impact**\\n`integer`\",\n    \"25-1\": \"What the Issue's schedule impact is in seconds. May be `null`.\"\n  },\n  \"cols\": 2,\n  \"rows\": 27\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"uid\\\": \\\"22f3530a-a00b-42f9-8139-3a7554c77c27\\\",\\n  \\\"number\\\": 1,\\n  \\\"current_annotation\\\": {\\n    \\\"uid\\\": \\\"6994b73b-c3b4-4aa3-a985-fd973e599526\\\",\\n    \\\"color\\\": \\\"#F38109\\\",\\n    \\\"stamp\\\": \\\"E\\\",\\n    \\\"visibility\\\": \\\"master\\\",\\n    \\\"deleted\\\": false,\\n    \\\"sheet\\\": {\\n      \\\"uid\\\": \\\"f3718ded-9919-4667-a746-969fda1cfe26\\\",\\n      \\\"url\\\": \\\"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/sheets/f3718ded-9919-4667-a746-969fda1cfe26\\\"\\n    }\\n  },\\n  \\\"title\\\": \\\"Electrical\\\",\\n  \\\"room\\\": \\\"M100\\\",\\n  \\\"description\\\": \\\"Missing wall outlets.\\\",\\n  \\\"assigned_to\\\": [{\\n    \\\"uid\\\": \\\"80efb7e6-f15c-479a-8429-7e153b1e2a52\\\",\\n    \\\"url\\\": \\\"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/users/80efb7e6-f15c-479a-8429-7e153b1e2a52\\\",                \\n    \\\"email\\\": \\\"bob@subcontractor.com\\\"\\n  }],\\n  \\\"status\\\": \\\"open\\\",\\n  \\\"created_at\\\": \\\"2015-06-08T18:04:02+00:00\\\",\\n  \\\"created_by\\\": {\\n    \\\"uid\\\": null,\\n    \\\"url\\\": null,\\n    \\\"email\\\": \\\"alfred@architect.com\\\"\\n  },\\n  \\\"updated_at\\\": \\\"2013-05-23T19:22:56+00:00\\\",\\n  \\\"updated_by\\\": {\\n    \\\"uid\\\": null,\\n    \\\"url\\\": null,\\n    \\\"email\\\": \\\"betty@construction.com\\\"\\n  },\\n  \\\"photos\\\": {\\n    \\\"total_count\\\": 1,\\n    \\\"url\\\": \\\"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/issues/22f3530a-a00b-42f9-8139-3a7554c77c27/photos\\\"\\n  },\\n  \\\"comments\\\": {\\n    \\\"total_count\\\": 0,\\n    \\\"url\\\": null\\n  },\\n  \\\"due_at\\\": \\\"2016-10-31T15:32:26+00:00\\\",\\n  \\\"has_cost_impact\\\": true,\\n  \\\"cost_impact\\\": 25850.10,\\n  \\\"currency_code\\\": \\\"USD\\\",\\n  \\\"has_schedule_impact\\\": true,\\n  \\\"schedule_impact\\\": 186400,\\n  \\\"deleted\\\": false\\n}\",\n      \"language\": \"json\"\n    }\n  ],\n  \"sidebar\": true\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Archived Issues\"\n}\n[/block]\nWhen an issue is archived through the PlanGrid client apps, it is hidden on the sheet but visible in the issue log. An issue is represented through the PlanGrid API as an issue whose `deleted` value is `false` and whose `current_annotation.deleted` is `true`.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"deleted\\\": false,\\n  \\\"current_annotation\\\": {\\n    \\\"deleted\\\": true,\\n    \\\"sheet\\\": {\\n      ...\\n    }\\n    ...\\n  },\\n  ...\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"the-issue-object","type":"basic","title":"The Issue Object","__v":0,"childrenPages":[]}

{"_id":"59c4267167a94900103a257c","category":"59c4267167a94900103a256a","user":"55d201fe945e481700afbb19","project":"55d2023b3c74062300aee506","parentDoc":null,"version":"59c4267167a94900103a2560","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-03-19T21:05:36.806Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"method":"get","results":{"codes":[{"language":"json","code":"{\n  \"data\": [\n    {\n      \"uid\": \"22f3530a-a00b-42f9-8139-3a7554c77c27\",\n      \"number\": 1,\n      \"current_annotation\": {\n        \"uid\": \"6994b73b-c3b4-4aa3-a985-fd973e599526\",\n        \"color\": \"#F38109\",\n        \"stamp\": \"E\",\n        \"visibility\": \"master\",\n        \"deleted\": false,\n        \"sheet\": {\n          \"uid\": \"f3718ded-9919-4667-a746-969fda1cfe26\",\n          \"url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/sheets/f3718ded-9919-4667-a746-969fda1cfe26\"\n        }\n      },\n      \"title\": \"Electrical\",\n      \"room\": \"M100\",\n      \"description\": \"Missing wall outlets.\",\n      \"assigned_to\": [{\n        \"uid\": \"80efb7e6-f15c-479a-8429-7e153b1e2a52\",\n        \"url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/users/80efb7e6-f15c-479a-8429-7e153b1e2a52\",\n        \"email\": \"bob@subcontractor.com\"\n      }],\n      \"status\": \"open\",\n      \"created_at\": \"2015-06-08T18:04:02+00:00\",\n      \"created_by\": {\n        \"uid\": null,\n        \"url\": null,\n        \"email\": \"alfred@architect.com\"\n      },\n      \"updated_at\": \"2013-05-23T19:22:56+00:00\",\n      \"updated_by\": {\n        \"uid\": null,\n        \"url\": null,\n        \"email\": \"betty@construction.com\"\n      },\n      \"photos\": {\n        \"total_count\": 0,\n        \"url\": null\n      },\n      \"comments\": {\n        \"total_count\": 2,\n        \"url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/issues/22f3530a-a00b-42f9-8139-3a7554c77c27/comments\"\n      },\n      \"due_at\": \"2016-11-02T10:12:28+00:00\",\n      \"has_cost_impact\": true,\n      \"cost_impact\": 1800.00,\n      \"currency_code\": \"USD\",\n      \"has_schedule_impact\": false,\n      \"schedule_impact\": null,\n      \"deleted\": false\n    },\n    {\n      \"uid\": \"51cb7310-6feb-47ae-8ad9-a89ac6101294\",\n      \"number\": 2,\n      \"current_annotation\": {\n        \"uid\": \"6994b73b-c3b4-4aa3-a985-fd973e599526\",\n        \"color\": \"#F38109\",\n        \"stamp\": \"CN\",\n        \"visibility\": \"master\",\n        \"deleted\": false,\n        \"sheet\": {\n          \"uid\": \"f3718ded-9919-4667-a746-969fda1cfe26\",\n          \"url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/sheets/f3718ded-9919-4667-a746-969fda1cfe26\"\n        }\n      },\n      \"title\": \"Cleaning Needed\",\n      \"room\": \"M101\",\n      \"description\": \"Clean paint and drywall mud from fire alarm.\",\n      \"assigned_to\": [{\n        \"uid\": \"80efb7e6-f15c-479a-8429-7e153b1e2a52\",\n        \"url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/users/80efb7e6-f15c-479a-8429-7e153b1e2a52\",\n        \"email\": \"bob@subcontractor.com\"\n      }],\n      \"status\": \"open\",\n      \"created_at\": \"2015-06-08T18:04:02+00:00\",\n      \"created_by\": {\n        \"uid\": null,\n        \"url\": null,\n        \"email\": \"alfred@architect.com\"\n      },\n      \"updated_at\": \"2013-05-23T19:22:56+00:00\",\n      \"updated_by\": {\n        \"uid\": null,\n        \"url\": null,\n        \"email\": \"betty@construction.com\"\n      },\n      \"photos\": {\n        \"total_count\": 1,\n        \"url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/issues/51cb7310-6feb-47ae-8ad9-a89ac6101294/photos\"\n      },\n      \"comments\": {\n        \"total_count\": 2,\n        \"url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/issues/51cb7310-6feb-47ae-8ad9-a89ac6101294/comments\"\n      },\n      \"due_at\": null,\n      \"has_cost_impact\": false,\n      \"cost_impact\": null,\n      \"currency_code\": null,\n      \"has_schedule_impact\": true,\n      \"schedule_impact\": 259200,\n      \"deleted\": false\n    }\n  ],\n  \"total_count\": 50,\n  \"next_page_url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/issues?skip=2&limit=2\"\n}\n","name":"Success","status":200},{"name":"Archived Issue","status":200,"language":"json","code":"{\n  \"data\": [\n    {\n      \"uid\": \"22f3530a-a00b-42f9-8139-3a7554c77c27\",\n      \"number\": 1,\n      \"current_annotation\": {\n        \"uid\": \"6994b73b-c3b4-4aa3-a985-fd973e599526\",\n        \"color\": \"#F38109\",\n        \"stamp\": \"E\",\n        \"visibility\": \"master\",\n        \"deleted\": true,\n        \"sheet\": {\n          \"uid\": \"f3718ded-9919-4667-a746-969fda1cfe26\",\n          \"url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/sheets/f3718ded-9919-4667-a746-969fda1cfe26\"\n        }\n      },\n      \"title\": \"Electrical\",\n      \"description\": \"Missing wall outlets.\",\n      \"assigned_to\": [{\n        \"uid\": \"80efb7e6-f15c-479a-8429-7e153b1e2a52\",\n        \"url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/users/80efb7e6-f15c-479a-8429-7e153b1e2a52\",\n        \"email\": \"bob@subcontractor.com\"\n      }],\n      \"status\": \"open\",\n      \"created_at\": \"2015-06-08T18:04:02Z\",\n      \"created_by\": {\n        \"uid\": null,\n        \"url\": null,\n        \"email\": \"alfred@architect.com\"\n      },\n      \"updated_at\": \"2013-05-23T19:22:56Z\",\n      \"room\": \"S20\",\n      \"updated_by\": {\n        \"uid\": null,\n        \"url\": null,\n        \"email\": \"betty@construction.com\"\n      },\n      \"deleted\": false,\n      \"photos\": {\n        \"total_count\": 0,\n        \"url\": null\n      },\n      \"comments\": {\n        \"total_count\": 2,\n        \"url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/issues/22f3530a-a00b-42f9-8139-3a7554c77c27/comments\"\n      }\n    },\n  ],\n  \"total_count\": 10,\n  \"next_page_url\": \"https://io.plangrid.com/projects/bafce976-8f33-437f-9c52-fb274456940f/issues?skip=1&limit=1\"\n}\n"},{"code":"{\n  \"message\": \"Project (bafce976-8f33-437f-9c58-fb274456940f) does not exist.\"\n}\n","name":"Project Missing","status":404,"language":"json"},{"status":403,"language":"json","code":"{\n  \"message\": \"Access to project (bafce976-8f33-437f-9c58-fb274456940f) prohibited.\"\n}\n","name":"No Project Access"}]},"settings":"","auth":"required","params":[{"_id":"56cf1eca5267d70b00494ba2","ref":"","in":"path","required":true,"desc":"Unique identifier of project.","default":"","type":"string","name":"project_uid"},{"_id":"56cf1eca5267d70b00494ba1","ref":"","in":"query","required":false,"desc":"Number of issues to retrieve. Maximum value of 50.","default":"50","type":"int","name":"limit"},{"_id":"56cf1eca5267d70b00494ba0","ref":"","in":"query","required":false,"desc":"Number of issues to skip in the set of results.","default":"0","type":"int","name":"skip"},{"_id":"56edbf5efc1410200082dc72","ref":"","in":"query","required":false,"desc":"Only retrieve issues created/updated after specified UTC date and time. See [Timestamps and Timezones](doc:timestamps-and-timezones) for accepted date formats.","default":"","type":"datetime","name":"updated_after"}],"url":"/projects/:project_uid/issues"},"isReference":false,"order":48,"body":"","excerpt":"Get a list of issues in a project. _All issues_ inside a project are returned, including deleted, archived, and personal issues across all team members. Results are paginated, see [Pagination](doc:pagination) for details on how pagination works in PlanGrid's API.","slug":"retrieve-issues-in-a-project","type":"get","title":"Retrieve Issues in a Project","__v":0,"childrenPages":[]}