{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/v:version/persons/:id.json","auth":"required","method":"put","examples":{"codes":[{"language":"json","code":"{\n \"position\":\"CEO\",\n \t\"wants_mailing\":false,\n \"wants_no_email\":true,\n \t\"fb_custom_fields\":[\n {\n \"id\":9,\n \"value\":\"yellow\"\n }\n ]\n}"}]},"settings":"","results":{"codes":[{"status":201,"language":"json","code":"{\n \"id\":733,\n \"company_id\":null,\n \"salutation\":\"Mr.\",\n \"title\":\"Dr\",\n \"first_name\":\"John\",\n \"last_name\":\"Doe\",\n \"birthday\":\"2000-01-01\",\n \"position\":\"CEO\",\n \"info\":\"A really nice guy!\",\n \"wants_mailing\":false,\n \"wants_newsletter\":false,\n \"wants_no_email\":true,\n \"wants_no_post\":false,\n \"wants_no_call\":false,\n \"greeting\":\"\",\n \"external_person_id\":\"ae34\",\n \"created_at\":\"2019-04-24 13:44:57\",\n \"updated_at\":\"2019-04-24 13:44:57\",\n \"fb_custom_fields\":[\n {\n \"id\":9,\n \"name\":\"Favorite Color\",\n \"value\":\"yellow\"\n }\n ],\n \"fb_person_addresses\":[],\n \t\"fb_person_phones\":[\n {\n \t\"id\":274,\n \"fb_person_id\":733,\n \"phone\":\"0123456789\",\n \"type\":\"work\",\n \"is_main\":true\n },\n {\n \t\"id\":275,\n \"fb_person_id\":733,\n \"phone\":\"+49 777 888 999\",\n \"type\":\"home\",\n \"is_main\":false\n }\n ],\n \"fb_person_email_addresses\":[],\n \"fb_person_websites\":[],\n \"fb_person_instant_messengers\":[],\n \"fb_person_bank_accounts\":[],\n \"fb_person_credit_cards\": [],\n \"fb_manual_tags\":[]\n}","name":""}]},"params":[{"name":"id","type":"int","default":"","desc":"Person ID","required":true,"in":"path","ref":"","_id":"5cc050113186000014865b63"}]},"next":{"description":"","pages":[]},"title":"/persons/:id.json","type":"endpoint","slug":"persons-edit","excerpt":"Edits an existing person.","body":"An overview of all fields could be found at the [description of the POST request](doc:persons-create).\n\nTo create, update or delete child objects like fb_person_phone or fb_person_bank_accounts please take a look at the special endpoints like /personPhone, /personBankAccount etc.\n[block:callout]\n{\n \"type\": \"info\",\n \"title\": \"Custom fields\",\n \"body\": \"Please find further information about custom fields [at the custom fields section](doc:custom-fields).\"\n}\n[/block]","updates":[],"order":25,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5cc04ff6c90f8100572febdd","project":"571f5e8cd8667f0e00a3c498","version":{"version":"1","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["571f5e8cd8667f0e00a3c49c","571f73cfcb4baa0e00d13a80","571f7451cb4baa0e00d13a88","571f7d2720695f3400f38797","571f7fb0ac2a080e0014c661","571f884be54f2d0e003ebb0a","572200c9ecb38d0e00d80ebd","572c301e7c8eff0e00aaa174","57df91b2c6348d0e0020c452","57e104db9ff1e21900a721ab","57fd04caeaa77f19008b8202","5899c7113514ce0f0014da84","5cbeda4b862d090013abd413","5e60d6278f8b380072f0b1e3"],"_id":"571f5e8cd8667f0e00a3c49b","hasDoc":true,"releaseDate":"2016-04-26T12:26:52.312Z","__v":14,"hasReference":true,"createdAt":"2016-04-26T12:26:52.312Z","project":"571f5e8cd8667f0e00a3c498"},"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"JSON-REST-API (API-Package)","slug":"rest-api-json","order":9,"from_sync":false,"reference":false,"_id":"5cbeda4b862d090013abd413","project":"571f5e8cd8667f0e00a3c498","version":"571f5e8cd8667f0e00a3c49b","createdAt":"2019-04-23T09:26:35.210Z","__v":1},"user":"5720ba18c669e80e00c35051","createdAt":"2019-04-24T12:00:54.576Z","__v":11,"parentDoc":null}
put/persons/:id.json
Edits an existing person.
Definition
{{ api_url }}{{ page_api_url }}
Parameters
Path Params
id:
required
integer
Person ID